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 <[email protected]> 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 <[email protected]> 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 <[email protected]> >> 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 <[email protected]> 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
