[Typo3-typo3org] documentation.typo3.org
Michael Scharkow
mscharkow at gmx.net
Wed Apr 13 22:03:47 CEST 2005
Peter Kindström wrote:
>> - how can we keep or improve usability on the typo3.org site?
>> it would be a weird browsing experience to search the extension
>> on one site and read the documentation on the other.
>
>
> This *is* important. See above. We also have to consider the
> wiki/timtaw idea. Documents could be edited online...
Does timtaw exist, or is it still vaporware. And concerning the wiki: I
really don't see a way of
a) Letting people write docs with OO
b) Making these changes editable (wiki/timtaw)
c) getting those changes back into the OOwriter file
d) all this version-controlled
without a hell of a lot of work.
> - We need documentation versioning
Subversion can handle binary files (=oowriter files), subversion has GUI
frontends.
> - It has to be easy for developers to make documentation
oowriter is as easy as it gets...
> - ...but we also have to have a good documentation format/tool
> for more proffessional document writers.
this, too, can be done with OO and a rigid template file to start from
> - Not only the author, but also the docTeam should be able to
> manage at least some of the documents.
This is a matter of managing access to version control.
The problem I see is that we want far too much at the same time: We
should concentrate either on
a) server-side editing (=wiki/timtaw) with built-in versioning
b) client-side editing (=oowriter) with a dedicated version management
Both these require different infrastructure on documentation.typo3.org,
not to mention the hassles of having a docteam and the gazillions of
extension doc writers.
Greetings,
Michael
More information about the TYPO3-team-typo3org
mailing list