[TYPO3-doc] Official documentation guidelines

[Francois Suter]

Hi,

> In the moment we have a shared user to 1. commit to the SVN repository
> and 2. publish manuals on typo3.org TER. That's easy and trusted.

This will definitely not be the case in the "official documentation" 
project. I precisely set it up (with the help of Andreas and Sebastian), 
so that each document can have its own team, independent of the others. 
I think this is really important if we want to have a larger number of 
people working on the docs, but still keep control over who does what 
(to ensure quality).

About the release to the TER we could create a common user, but I would 
like the release process to stay in a very limited set of hands, people 
that would be considered like "editors in chief". OTOH if some manual 
has a clear leader, then that leader could be owner of that specific key 
and do releases himself. It's just a question of following the guidelines.

> Let's see if it works when we move the manuals we maintained so far to
> the "Core Documentation" project. A problem can be this: A manual-editor
> first needs to get member of a project and so maybe doesn't ask for the
> right to attend the team.

I think this is a really small overhead. And we can include this in the 
guidelines.

-- 

Francois Suter
Cobweb Development Sarl - http://www.cobweb.ch