On Mon, Mar 22, 2010 at 9:34 AM, Markus Weimar
<[email protected]> wrote:
> I am planning to contribute:
> - tabular API-like function docs
> - concise system pages with a structuring heading here and there
> - usability improvements to boltwire.com
> - making the docs homogeneous and concise and add more textual structuring

I might only suggest, doing one API like function page first and then
solicit feedback before doing more.

If we can get the first one right, then it becomes a template for all
the other. Come up with a great idea later, we'd have to change
multiple pages...

On a structural note, were you thinking one long page with all the
functions, or putting the chart on a separate page for each function?
If the latter I'd propose we move all the barn pages under the
handbook hiearchy, so we'd have pages like:

docs
docs.handbook
docs.handbook.functions
docs.handbook.functions.breadcrumb

I could whip up a bit of code in docs.handbook.footer to retrieve the
code soure at the click of a button when p0=4. It might take a bit of
time to move over all the barn pages, but we could start fresh also,
as I don't think most of those pages have any content.

This is the direction I'd like to go, but I'm having a hard time
keeping up with everything...

Cheers,
Dan

-- 
You received this message because you are subscribed to the Google Groups 
"BoltWire" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/boltwire?hl=en.

Reply via email to