Noah Kantrowitz wrote: > It looks like a user by the name of ThurnerRupert has recently gone > through and made several of the default wiki pages (most notably > TracInstall) all talk about 0.11. While this is all nice and good, the > default instructions users should see should still be for the released > version (0.10 for those playing along at home).
Emphasis put on *this is all nice and good*, as we need more contributions like this. However, it's true that it can get confusing which information goes with which version, especially on a wiki where each contributor has his own notion of the "right thing" to do. So I propose that we adopt some guidelines. One idea could be to have the TracGuide pages (TracInstall, WikiFormatting, etc.) be a kind of "melting pot" of useful information (i.e. as it is now), with the additional constraints that each edit has to be clear about which version of Trac is concerned. Then, we would have a 0.10/TracGuide series of pages that would be "official" stable version of the guide, which is periodically synced in the repository before each stable release. Each edit made there has to be done only in order to improve the documentation related to Trac 0.10, exclusively. Lastly, we would have a 0.11/TracGuide series of pages which will be the preparation area for the official 0.11 documentation. In summary: TracGuide et al. for true "wiki style" user edits, while 0.10/TracGuide and 0.11/TracGuide should be written with higher standards in mind. Of course, useful informations from the TracGuide should flow in either the 0.10/TracGuide or 0.11/TracGuide as appropriate, but "edited". > To all current and > future wiki contributers, if you want to add new features to the > documentation, we welcome it, but please don't do it at the expense of > users using other supported versions. In general, version specific > features should be clearly marked as such. If a new version of a page is > needed, just prefix it's name with the version (like 0.11/TracInstall) > and work on the page there. Yes, a prefix is needed (0.11/TracInstall rather than TracInstall/0.11), so that the [[TracGuideToc]] macro can work (well, there's apparently a little bug right now with that one - will be fixed soon). -- Christian --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Trac Users" 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-users?hl=en -~----------~----~----~----~------~----~------~--~---
