A note about the docfile structure: dynapi3x/docs/docs seems redundant.
files with the "quickref" prefix seem redundant and might best be
collected in dynapi3x/docs/quickref instead. The flattened
"quickref.NAME.html" format might not best reflect the structure of the
code. For example with this Graphics example, could it perhaps be
better as "quickref.dynapi.gui.graphics.html".
To combine all suggestions:
dynapi3x/docs/docs/quickref.gui.html
would become:
dynapi3x/docs/quickref/dynapi.gui.graphics.html
dynapi3x/examples/dynapi.gui.graphics.html
Which would better parallel the naming structure used for the examples,
and make things easier to find overall.
The following pages could then be deposited into dynapi3x/docs instead
of dynapi3x/docs/docs:
contributors, main examples, main quickref, key features, license, faq,
requirements, roadmap, tipsticks (heh, tipstricks with an R?),
troubleshoot and whatsnew
The tip.NAME.html could stay in docs for now, or go into a tips folder.
Comments or suggestions?
Leif
|
