On May 16, 12:40 am, Noah Kantrowitz <[EMAIL PROTECTED]> wrote: > Christian Boos wrote: > > Bottom line: > > Improving the documentation system for Trac should motivate us to make > > Trac better at writing documentation, not prompt us to ditch Trac in > > favor of another tool for doing that job. > > This was discussed in depth a while ago, but I will sum up the key > points here. > > 1) A wiki exists for communication, taking quick notes, and to act as a ... > gain easy branching, thus warding off the current insanity with > 0.1[012]/* page names and such. It also allows us to move to a > submit-a-patch workflow as we do with code. Documentation is just as > critical as any other part of the project, and as much as I like > community involvement, it has become clear through experience that wikis > do not work for our needs. ReST has an existing and powerful > documentation toolchain that very closely matches our needs, so I think > it is a logical fit. We will indeed be "eating our own dogfood", as the > newhelp system designed for this will be exposed to projects using Trac > for their own documentation needs (with the t.e.o methodology and > toolchain serving as an example of how to use it).
while i see the point you make, noah, not beeing able to freeze/tag/ branch the wiki including the tickets, documents, and source code is one of our major issues in getting more user acceptance for trac. because first it is an idea or a ticket, then it should be documented. and there should be a trace how things developed. so christians idea has some appeal ... for us anyway. moinmoin btw even tries to get a mercurial backend, see http://code.google.com/soc/2008/moin/appinfo.html?csaid=1050E6FC80FD185E. rupert. --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Trac Development" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/trac-dev?hl=en -~----------~----~----~----~------~----~------~--~---
