Re: Manual Pages Mockup

On 07/13/2011 06:47 PM, Philip Olson wrote:

On Jul 13, 2011, at 1:54 PM, Paul Dragoonis wrote:

On Wed, Jul 13, 2011 at 9:09 PM, Wojciech Kupiec<kupiec.w@gmail.com> wrote:

On 07/13/2011 07:53 AM, Stewart Lord wrote:

Thanks for working on this Wojak. There are definitely parts of this that I like. I haven't spent much time thinking about the manual pages, but I will do that and get back to you.

That is ok. Meanwhile I have been considering the issue with paragraphs and here is an idea how to distinguish them, by adding a frame around: http://wojak.u.bitbit.net/manual_paragraph.png

I'm happy to implement this paragraph (fieldset) style separation. Lets get some input from other guys.

I am nowhere near being a designer type, but the lack of contrast (I think) makes this difficult to read. Keeping with the is_int() example, here's what the sphinx theme looks like: http://moacirdeoliveira.com/phd/sphinx/function.is-int.html Not proposing this, but something about this scheme makes it easier to read. Maybe the color issue is a site-wide problem, not sure, but hopefully one of the designer nerds could share insight and ideas on the matter. But regardless, the proposed manual look is an improvement over the current.

I agree with these points - including the last one. Chris -- Email: christopher.jones@oracle.com Tel: +1 650 506 8630 Blog: http://blogs.oracle.com/opal/