First of all, I plan on having a manual.freeems.org site too for user instructions, setup for hardware, etc etc. This will exist for other types of firm docs such as the doxygen stuff and other standalone items such as currently found in the docs directory of the source tree.
I guess what I want to hear are ideas about what we might need. I don't want to make the tree of URLs too shallow as that would be limiting later on.
I foresee :
A top level page with links to other forms of docs like the manual, forum, wiki etc and links to the available content further down the tree on this domain :
- General docs?
- Software docs
- Hardware docs
- Tuning - on a pc or cell phone or psp or whatever
- Firmware - on an xdp512 based device running an engine or other function on the car
For hardware it will likely end up divided like so :
- Free - Designs available under suitable license - DIY and/or commercial built.
- Commercial DIY Built (boards ah la MS)
- Commercial Assembled (devices ah la Motec, MS-PNP, etc (still must use FreeEMS firmware))
So, the first task is where to keep the doxygen stuff and the existing firmware docs.
Code: Select all
http://docs.freeems.org/soft/firm/vanilla/doxy/<version>/index.htm etc
Code: Select all
http://docs.freeems.org/software/firmware/vanilla/doxygen/<version>/index.htm etc
Perhaps top level of :
- General docs?
- Firmware docs
- Software docs
- Hardware docs
You may be thinking "shed colour" but getting it wrong up front means redirects and 404s later, so it should have some thought put into it now IMO.
What have I done wrong, what is missing, positive reinforcement etc please.
Fred.