On 07/12/2013 07:10 AM, Bernhard Bitsch wrote:
On your note about that development has to be involved in this as well: Agreed and I already talked to Arne and Stevee how we can do that in the least time consuming way, because we also don't have much time and loads of things to work on.
Sorry, documentation is not an addon, but a essential part of development.
Writing articles in more than one language is an absolute no-go.
Agreed. ;)
We will leave it at English and write down the most important things one needs to know about a certain add-on or what ever.
Most developpers are native german speakers. Why not using german?
I vote for English, and not because I am a native speaker, but for the assumption that more people use it as a second language than German. I speak English and (very poor) Spanish. I have Russian, Filipino, German and Spanish native speakers I correspond with regularly because they learned English in school.
I can't speak for other countries, but in the US, most of the multilingual learn Spanish, French, German, Russian, Mandarin and Japanese. However, I believe most of the multilingual in other countries learn English as their second language, then go on to other languages after that. I am speaking from my own experience, however, so I may be wrong on this.
I also think that developers are not the best people to write end-user documentation. It is getting to complex and not suitable for beginners any way.
Also agreed. But without a basic documentation a non-developper can't write a end user doc. The devs mainly know about the internals. A non-dev can only study the behaviour or ask the devs.
- Bernhard
Documentation mailing list Documentation@lists.ipfire.org http://lists.ipfire.org/mailman/listinfo/documentation