Hey, On 14 oct, 06:12, Michael Pedersen <[email protected]> wrote:
> On Tue, Oct 12, 2010 at 9:57 AM, Emmanuel Cazenave <[email protected]> wrote: > > I've used TG for a couple of days. I'v been very disturbed by the fact > > that there are two different templates for the doc. > > I've got to ask: Why is it disturbing? TG 2.0.x is the current > stable version. TG 2.1 is under development, including > documentation enhancements to fix the shortcomings we have > identified in the 2.0.x docs. It's only natural that we work on > making the new docs look the best that we can make them look. Well the problem is that you don't know which version of the docs you are reading. Ok the info is in the url (2.0/docs vs 2.1/docs), but personnaly I don't notice the url. That's why it tooked me some time to understand why there were two different templates. In the meantime it feels like the documentation is a mess; sorry for that but that's what I felt. In the django docs for example, there is a big fat reminder on top off every page, telling you which version of the doc you are browsing, and there is also a reminder of that on the side bar. So to say that in my opinion highlighting the version info would very helpful, especially for new users. -- You received this message because you are subscribed to the Google Groups "TurboGears Trunk" 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/turbogears-trunk?hl=en.
