You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@avro.apache.org by Suraj Acharya <su...@apache.org> on 2017/05/22 02:53:40 UTC
Help with the website release.
Hey guys,
I am trying to work on the release.
However, the docs for 1.8.2 are not getting pushed. Does anyone have
experience with it, or does anyone have some ideas on what are the next
steps are to push the 1.8.2 docs?
Currently, the link on the website is broken and I am trying to look into
it.
Step 13 of this guide is where I am stuck :
https://cwiki.apache.org/confluence/display/AVRO/How+To+Release
S
Re: Help with the website release.
Posted by suraj acharya <su...@gmail.com>.
Thanks, the website is now back up.
I created AVRO-2038 to fix the issue.
I will send out an official announcement once I finish the last few tasks.
S
-Suraj Acharya
On Tue, May 30, 2017 at 11:29 AM, Sean Busbey <bu...@cloudera.com> wrote:
> okay, something is up with our docs build. I finally got forrest
> installed and ran just the step that happens at "(cd doc; ant)". I get
> the missing files but they're in build directories that have extra
> characters at the end (looks like a space for one and a ^J for the
> other):
>
> ----
>
> Busbey-MBA:avro busbey$ ls -lah build
> total 8
> drwxr-xr-x 5 busbey staff 170B May 30 11:24 .
> drwxr-xr-x 17 busbey staff 578B May 30 11:26 ..
> drwxr-xr-x 3 busbey staff 102B May 30 11:24 avro-doc-1.8.2?
> drwxr-xr-x 22 busbey staff 748B May 30 11:24 avro-doc-1.8.2
> -rw-r--r-- 1 busbey staff 42B May 30 11:24 avro.ent
> Busbey-MBA:avro busbey$ ls -lah build/avro-doc-1.8.2
> avro-doc-1.8.2^J/avro-doc-1.8.2 /
> ls -lah build/avro-doc-1.8.2\ /
> total 992
> drwxr-xr-x 22 busbey staff 748B May 30 11:24 .
> drwxr-xr-x 5 busbey staff 170B May 30 11:24 ..
> -rw-r--r-- 1 busbey staff 31B May 30 11:24 broken-links.xml
> -rw-r--r-- 1 busbey staff 27K May 30 11:24 gettingstartedjava.html
> -rw-r--r-- 1 busbey staff 35K May 30 11:24 gettingstartedjava.pdf
> -rw-r--r-- 1 busbey staff 15K May 30 11:24 gettingstartedpython.html
> -rw-r--r-- 1 busbey staff 19K May 30 11:24 gettingstartedpython.pdf
> drwxr-xr-x 3 busbey staff 102B May 30 11:24 htmldocs
> -rw-r--r-- 1 busbey staff 23K May 30 11:24 idl.html
> -rw-r--r-- 1 busbey staff 39K May 30 11:24 idl.pdf
> drwxr-xr-x 7 busbey staff 238B May 30 11:24 images
> -rw-r--r-- 1 busbey staff 8.9K May 30 11:24 index.html
> -rw-r--r-- 1 busbey staff 12K May 30 11:24 index.pdf
> -rw-r--r-- 1 busbey staff 7.4K May 30 11:24 linkmap.html
> -rw-r--r-- 1 busbey staff 9.4K May 30 11:24 linkmap.pdf
> -rw-r--r-- 1 busbey staff 29K May 30 11:24 mr.html
> -rw-r--r-- 1 busbey staff 33K May 30 11:24 mr.pdf
> -rw-r--r-- 1 busbey staff 11K May 30 11:24 sasl.html
> -rw-r--r-- 1 busbey staff 18K May 30 11:24 sasl.pdf
> drwxr-xr-x 22 busbey staff 748B May 30 11:24 skin
> -rw-r--r-- 1 busbey staff 76K May 30 11:24 spec.html
> -rw-r--r-- 1 busbey staff 96K May 30 11:24 spec.pdf
> ----
>
> The later build steps naturally ignore these directories.
>
> On Tue, May 30, 2017 at 11:03 AM, Sean Busbey <bu...@cloudera.com> wrote:
> > I agree with Suraj that it looks like building the docs in the release
> > process resulted in a tarball that's missing some of the index.html
> > files. I'm trying to run a doc build from the commit for 1.8.2 now to
> > see if we can just make something usable for the web this go-round and
> > fix future releases.
> >
> > On Mon, May 22, 2017 at 4:56 PM, Suraj Acharya <su...@apache.org> wrote:
> >> So i did add the docs tarball.
> >> Ran a tar xvf on the tarball.
> >> However, this is the directory structure :
> >> sacharya@sacharya-MBP:~/repos/avro$ cd avro-doc-1.8.2/
> >> sacharya@sacharya-MBP:~/repos/avro/avro-doc-1.8.2$ ls
> >> LICENSE NOTICE api trevni
> >>
> >> The issue with this is that it creates an incorrect link : see
> >> http://avro.apache.org/docs/1.8.2/. There is no index.html
> >> I haven't changed the link from current, since I didn't want to break
> the
> >> whole website.
> >>
> >> S
> >>
> >> On Mon, May 22, 2017 at 10:53 AM, Ryan Blue <rb...@netflix.com.invalid>
> >> wrote:
> >>
> >>> I've updated the docs before. What's the problem? Did you add the docs
> >>> tarball from the release?
> >>>
> >>> On Sun, May 21, 2017 at 7:53 PM, Suraj Acharya <su...@apache.org>
> wrote:
> >>>
> >>> > Hey guys,
> >>> > I am trying to work on the release.
> >>> > However, the docs for 1.8.2 are not getting pushed. Does anyone have
> >>> > experience with it, or does anyone have some ideas on what are the
> next
> >>> > steps are to push the 1.8.2 docs?
> >>> >
> >>> > Currently, the link on the website is broken and I am trying to look
> into
> >>> > it.
> >>> >
> >>> > Step 13 of this guide is where I am stuck :
> >>> > https://cwiki.apache.org/confluence/display/AVRO/How+To+Release
> >>> >
> >>> > S
> >>> >
> >>>
> >>>
> >>>
> >>> --
> >>> Ryan Blue
> >>> Software Engineer
> >>> Netflix
> >>>
> >
> >
> >
> > --
> > busbey
>
>
>
> --
> busbey
>
Re: Help with the website release.
Posted by Sean Busbey <bu...@cloudera.com>.
okay, something is up with our docs build. I finally got forrest
installed and ran just the step that happens at "(cd doc; ant)". I get
the missing files but they're in build directories that have extra
characters at the end (looks like a space for one and a ^J for the
other):
----
Busbey-MBA:avro busbey$ ls -lah build
total 8
drwxr-xr-x 5 busbey staff 170B May 30 11:24 .
drwxr-xr-x 17 busbey staff 578B May 30 11:26 ..
drwxr-xr-x 3 busbey staff 102B May 30 11:24 avro-doc-1.8.2?
drwxr-xr-x 22 busbey staff 748B May 30 11:24 avro-doc-1.8.2
-rw-r--r-- 1 busbey staff 42B May 30 11:24 avro.ent
Busbey-MBA:avro busbey$ ls -lah build/avro-doc-1.8.2
avro-doc-1.8.2^J/avro-doc-1.8.2 /
ls -lah build/avro-doc-1.8.2\ /
total 992
drwxr-xr-x 22 busbey staff 748B May 30 11:24 .
drwxr-xr-x 5 busbey staff 170B May 30 11:24 ..
-rw-r--r-- 1 busbey staff 31B May 30 11:24 broken-links.xml
-rw-r--r-- 1 busbey staff 27K May 30 11:24 gettingstartedjava.html
-rw-r--r-- 1 busbey staff 35K May 30 11:24 gettingstartedjava.pdf
-rw-r--r-- 1 busbey staff 15K May 30 11:24 gettingstartedpython.html
-rw-r--r-- 1 busbey staff 19K May 30 11:24 gettingstartedpython.pdf
drwxr-xr-x 3 busbey staff 102B May 30 11:24 htmldocs
-rw-r--r-- 1 busbey staff 23K May 30 11:24 idl.html
-rw-r--r-- 1 busbey staff 39K May 30 11:24 idl.pdf
drwxr-xr-x 7 busbey staff 238B May 30 11:24 images
-rw-r--r-- 1 busbey staff 8.9K May 30 11:24 index.html
-rw-r--r-- 1 busbey staff 12K May 30 11:24 index.pdf
-rw-r--r-- 1 busbey staff 7.4K May 30 11:24 linkmap.html
-rw-r--r-- 1 busbey staff 9.4K May 30 11:24 linkmap.pdf
-rw-r--r-- 1 busbey staff 29K May 30 11:24 mr.html
-rw-r--r-- 1 busbey staff 33K May 30 11:24 mr.pdf
-rw-r--r-- 1 busbey staff 11K May 30 11:24 sasl.html
-rw-r--r-- 1 busbey staff 18K May 30 11:24 sasl.pdf
drwxr-xr-x 22 busbey staff 748B May 30 11:24 skin
-rw-r--r-- 1 busbey staff 76K May 30 11:24 spec.html
-rw-r--r-- 1 busbey staff 96K May 30 11:24 spec.pdf
----
The later build steps naturally ignore these directories.
On Tue, May 30, 2017 at 11:03 AM, Sean Busbey <bu...@cloudera.com> wrote:
> I agree with Suraj that it looks like building the docs in the release
> process resulted in a tarball that's missing some of the index.html
> files. I'm trying to run a doc build from the commit for 1.8.2 now to
> see if we can just make something usable for the web this go-round and
> fix future releases.
>
> On Mon, May 22, 2017 at 4:56 PM, Suraj Acharya <su...@apache.org> wrote:
>> So i did add the docs tarball.
>> Ran a tar xvf on the tarball.
>> However, this is the directory structure :
>> sacharya@sacharya-MBP:~/repos/avro$ cd avro-doc-1.8.2/
>> sacharya@sacharya-MBP:~/repos/avro/avro-doc-1.8.2$ ls
>> LICENSE NOTICE api trevni
>>
>> The issue with this is that it creates an incorrect link : see
>> http://avro.apache.org/docs/1.8.2/. There is no index.html
>> I haven't changed the link from current, since I didn't want to break the
>> whole website.
>>
>> S
>>
>> On Mon, May 22, 2017 at 10:53 AM, Ryan Blue <rb...@netflix.com.invalid>
>> wrote:
>>
>>> I've updated the docs before. What's the problem? Did you add the docs
>>> tarball from the release?
>>>
>>> On Sun, May 21, 2017 at 7:53 PM, Suraj Acharya <su...@apache.org> wrote:
>>>
>>> > Hey guys,
>>> > I am trying to work on the release.
>>> > However, the docs for 1.8.2 are not getting pushed. Does anyone have
>>> > experience with it, or does anyone have some ideas on what are the next
>>> > steps are to push the 1.8.2 docs?
>>> >
>>> > Currently, the link on the website is broken and I am trying to look into
>>> > it.
>>> >
>>> > Step 13 of this guide is where I am stuck :
>>> > https://cwiki.apache.org/confluence/display/AVRO/How+To+Release
>>> >
>>> > S
>>> >
>>>
>>>
>>>
>>> --
>>> Ryan Blue
>>> Software Engineer
>>> Netflix
>>>
>
>
>
> --
> busbey
--
busbey
Re: Help with the website release.
Posted by Sean Busbey <bu...@cloudera.com>.
I agree with Suraj that it looks like building the docs in the release
process resulted in a tarball that's missing some of the index.html
files. I'm trying to run a doc build from the commit for 1.8.2 now to
see if we can just make something usable for the web this go-round and
fix future releases.
On Mon, May 22, 2017 at 4:56 PM, Suraj Acharya <su...@apache.org> wrote:
> So i did add the docs tarball.
> Ran a tar xvf on the tarball.
> However, this is the directory structure :
> sacharya@sacharya-MBP:~/repos/avro$ cd avro-doc-1.8.2/
> sacharya@sacharya-MBP:~/repos/avro/avro-doc-1.8.2$ ls
> LICENSE NOTICE api trevni
>
> The issue with this is that it creates an incorrect link : see
> http://avro.apache.org/docs/1.8.2/. There is no index.html
> I haven't changed the link from current, since I didn't want to break the
> whole website.
>
> S
>
> On Mon, May 22, 2017 at 10:53 AM, Ryan Blue <rb...@netflix.com.invalid>
> wrote:
>
>> I've updated the docs before. What's the problem? Did you add the docs
>> tarball from the release?
>>
>> On Sun, May 21, 2017 at 7:53 PM, Suraj Acharya <su...@apache.org> wrote:
>>
>> > Hey guys,
>> > I am trying to work on the release.
>> > However, the docs for 1.8.2 are not getting pushed. Does anyone have
>> > experience with it, or does anyone have some ideas on what are the next
>> > steps are to push the 1.8.2 docs?
>> >
>> > Currently, the link on the website is broken and I am trying to look into
>> > it.
>> >
>> > Step 13 of this guide is where I am stuck :
>> > https://cwiki.apache.org/confluence/display/AVRO/How+To+Release
>> >
>> > S
>> >
>>
>>
>>
>> --
>> Ryan Blue
>> Software Engineer
>> Netflix
>>
--
busbey
Re: Help with the website release.
Posted by Suraj Acharya <su...@apache.org>.
So i did add the docs tarball.
Ran a tar xvf on the tarball.
However, this is the directory structure :
sacharya@sacharya-MBP:~/repos/avro$ cd avro-doc-1.8.2/
sacharya@sacharya-MBP:~/repos/avro/avro-doc-1.8.2$ ls
LICENSE NOTICE api trevni
The issue with this is that it creates an incorrect link : see
http://avro.apache.org/docs/1.8.2/. There is no index.html
I haven't changed the link from current, since I didn't want to break the
whole website.
S
On Mon, May 22, 2017 at 10:53 AM, Ryan Blue <rb...@netflix.com.invalid>
wrote:
> I've updated the docs before. What's the problem? Did you add the docs
> tarball from the release?
>
> On Sun, May 21, 2017 at 7:53 PM, Suraj Acharya <su...@apache.org> wrote:
>
> > Hey guys,
> > I am trying to work on the release.
> > However, the docs for 1.8.2 are not getting pushed. Does anyone have
> > experience with it, or does anyone have some ideas on what are the next
> > steps are to push the 1.8.2 docs?
> >
> > Currently, the link on the website is broken and I am trying to look into
> > it.
> >
> > Step 13 of this guide is where I am stuck :
> > https://cwiki.apache.org/confluence/display/AVRO/How+To+Release
> >
> > S
> >
>
>
>
> --
> Ryan Blue
> Software Engineer
> Netflix
>
Re: Help with the website release.
Posted by Ryan Blue <rb...@netflix.com.INVALID>.
I've updated the docs before. What's the problem? Did you add the docs
tarball from the release?
On Sun, May 21, 2017 at 7:53 PM, Suraj Acharya <su...@apache.org> wrote:
> Hey guys,
> I am trying to work on the release.
> However, the docs for 1.8.2 are not getting pushed. Does anyone have
> experience with it, or does anyone have some ideas on what are the next
> steps are to push the 1.8.2 docs?
>
> Currently, the link on the website is broken and I am trying to look into
> it.
>
> Step 13 of this guide is where I am stuck :
> https://cwiki.apache.org/confluence/display/AVRO/How+To+Release
>
> S
>
--
Ryan Blue
Software Engineer
Netflix