[Typo3-doc] Wiki people: who's on board now?

[Alex Heizer]

Hi Peter,

Peter Kindström wrote:

>Hi,
>  
>
>>>A few months ago we found out that DocBook would be the perfect format
>>>for us but unfortunately we couldn't handle that technically. In the 
>>>new TER we now use DocBook internally so I suggest that we
>>>discuss changing to DocBook completely - after a planning and
>>>transition phase of course.
>>>
>>>      
>>>
>>I think DocBook would be a much better format.
>>    
>>
>
>Wait a minute!
>First I don´t think everybody was that positive. Maybe
>*technically* it is the perfect format, but you still have to
>think of the great majority of users: the developers!
>
>Is it easy enought for them to write documents in the DocBook
>format? A few month ago I tried to find an *easy to use* editor
>for DocBook but I failed...
>
>I don´t say this is wrong, I just agree with Robert that we have
>to have a (long?) transition phase. Maybe the "new docTeam"
>should start using the format to test it, find good editors and
>so on?
>
>But I think the most important thing is: If we want good
>documentation from our developers, the process of writing
>documentation must be at least as easy as using OpenOffice!
>  
>
I agree with these points. Again, I'm not looking at timelines or 
workloads, only solutions and general feasibility. Some things I know 
about, but I am intentionally ignoring a lot of what I do know about 
things so that I can look at all solutions without prejudice. So I 
apologize if sometimes it seems like I disregard some "minor" details 
like how much work would be involved to migrate 1000 extension manuals 
from one format to another! ;)

My feeling is to just get a list of what is possible, and then distill 
it down to what is hopeful, or at best probable. But no wholesale 
changes in anything until we see what our options are.

I can also contact the Blender people (whom I mentioned previously as an 
example) to see what their experiences are, and share them on the list. 
I think it needs to be as easy to use as OO or the wiki, or the 
transition time will be longer, and documentation will not be updated as 
often.

Thanks,

Alex