jclouds-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Andrew Bayer <andrew.ba...@gmail.com>
Subject Re: Documentation, let's discuss
Date Wed, 29 May 2013 01:41:20 GMT
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

- 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.
> Thanks,
> Becca

View raw message