On Fri, 2013-07-12 at 14:10 +0200, 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.
Nobody said that. But we don't have not very much man power in development and so there is nothing left to write end-user documentation.
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?
Because there are not enough people around who speak German and an other language to translate the content to. Just take it as it is: German is not the first language of this wiki and never will be.
The reasons for that are obvious and I have explained them to you more than once. So stop ranting about this on every occasion.
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.
What do you need to know about the "internals". Not very much. Development documentation and end-user documentation are two completely different things and we should not confuse those two.
As pointed out in my other email, I don't want to talk about development documentation here and I also don't want to talk about how the developers interact with the documentation team. There will be an information exchange, but I am not sure in what form at the moment and we will need to figure that out in the development team first.
-Michael