Difference between revisions of "Talk:Development documentation"

From ElphelWiki
Jump to: navigation, search
Line 15: Line 15:
  
 
I remove "Background" to the first place.
 
I remove "Background" to the first place.
 
Ilya.
 
  
 
And still.
 
And still.

Revision as of 14:45, 22 September 2005

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.

And still. Now the all new texts about developing. I think, I can move it to "stable" section later? After editing?

Ilya