Talk:Development documentation

From ElphelWiki
Revision as of 14:27, 22 September 2005 by Ilya (talk | contribs)
Jump to: navigation, search

Ilya, I've got somewhat lost when you rearranged material.

First of all I prefer clear division between user and developer documentation. For example "software" in the main menu should relate to the software that camera users are using, not the future software projects and ideas.

Second I prefer to have longer multi-section (so individually editable) scrollable pages with automatic "Contents" above, not small pages where you need to click and click back to get to somewhere. When the article will grow really big to scroll - then we can split the page in several.

So why did you split the "Roadmap" into smaller ones? Thinking that each section will eventually grow too big? Or big pages load slow through the dialup? Or something else?

The "Background" section I wrote for developers, not for the general "Software" section.

So, my early experience in translating the help files ;) One theme - one page. It's more usability. But you right - the documentation for "user" and "developer" must be different.

I remove "Background" to the first place.

Ilya.