I have absolutely no sense of aesthetics, so I'm not the right person to ask in re: navigability and aesthetics in general, but I do have two requests:

- Increase the font size of the text on pages - it's just too small to read on a big monitor without blowing up the page considerably.
- There should really be an easy link to find that'll get you to the javadocs for a given release. That's way too important to be hard to find or not there at all.


On Tue, May 28, 2013 at 6:12 PM, Becca Wood <silkysun@apache.org> wrote:
Hi everyone,

There are currently several conversations going on about docs, and the statements from some folks are blindsiding me as I read from thread to thread.

It would be great to have a discussion around what everyone does not like about the current docs process and why and how it should be changed.  It would also be good to address the aesthetic and navigability of the website.  Since I am responsible for a good deal of the current docs process on GitHub and the way the current website looks, it would be great to get some feedback on the strengths and weaknesses of both.

The aim of this discussion is to help us collect our thoughts in one place and create a more solid and contributor friendly process moving forward.

I don't want to be a hinderance or the single point of failure in our docs process, so if anyone is confused or has concerns about the current process, please let me know.