Re: Aw: Re: IPFire Wiki Workflow

[Michael Tremer <michael.tremer@ipfire.org>]

[-- Attachment #1: Type: text/plain, Size: 2084 bytes --]

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