> I echo this question. I don't know that it's going to take more > effort for sure.
What I meant is that up to now, we faced difficulties to maintain a coherent and up-to-date documentation. If users are offered both an "official" documentation and a user-maintained documentation - which would be both indexed by search engines - , while we do not have the bandwidth to update the official doc from the user-maintained one, I'm not sure it will help the users finding their ways in the various doc sources. I don't say that moving the doc to the repos is a bad idea, though. > Indeed, it's confusing. But we also need to keep in mind how search > engines are going to return docs. If someone searches for > "tracmercurial" and arrives at the wrong version, we need to make it > obvious how to switch to the right version of the docs. Very true. However I probably miss something important here, but the main source of the documentation is the online version available from trac.edgewall.org (whatever the doc is backed up in the repos or in the SQL db), not the local documentation an admin may - or may not - install on his server. Many admins simply don't want their project to be polluted with the wiki pages that come with the default install, nor install a local Trac project for the sake of having the documentation available locally. Most of the Trac documentation is about setting up Trac (i.e. admin doc), not about using it (i.e. user doc) At this point, having the doc in the repository may be nice to manage it (while it really matters for the Trac developers, not for Trac users/admin) but it may slow down how fast the changes are committed to the official area, leaving the user with confusing sources of information. Again I'm not against moving the doc to the repository, I just have some questions about how the user will be able to reach the right doc - and only the one he needs. -- Manu --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
