[TYPO3-doc] DocBook: sample reference file

[François Suter]

Hi,

> When I think of an TYPO3 backend interface for editing the TSref, it
> seems far more usable as editing XML. Maybe I miss something here (I've
> not done so much documentation maintenance by now).
> E.g. Versioning would be done by TYPO3....

TYPO3 does not seem the best tool to do versioning, especially when 
compared to versioning-control system like Subversion or Git.

>> Also it would follow the same logic as
>> the rest of the documentation.
>>
> Yes that seems to be an argument as well. Although I'm not so sure about
> the consequences of having different ways of documentation...

Everything is possible, of course, but if all the documentation is 
handled the same, it means it's easy for contributors to participate to 
various manuals, because the same logic is found everywhere. You don't 
have to say things like: "Oh, you want to contribute to the TSref? Well 
you have to request on account on wtf.typo3.org and work in a TYPO3 BE, 
and be sure to learn how to handle versioning properly." I would largely 
prefer if people were able to submit patches to a central place for any 
document.

Cheers

-- 

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