Karl Guertin wrote: > In the interest of reducing the amount of uncertainty surrounding TG, > the wiki is written only using the standard TG stack. Obviously, you > can use SA and Genshi as third party addons, but I'd like to keep > their impact on the 1.0/* pages to that. They should live in their own > separate pages that discuss them while every other page ignores them. > At the moment, the only stray mentions of SA are in IdentityManagement > and it's split friends. The only other mentions are on the > Configuration and tg-admin reference pages and that is by design. > There are no stray Genshi references and there should be no further > mentions of SA under 1.0/*. > > In checking out 1.0/RD/WidgetsOverview, I noticed that there's a > section on ToscaWidgets. This is not a good thing. TW is not and, to > my knowledge, will not be in the 1.0 release line. I don't want to > create additional uncertainty around the framework (like the SO/SA and > Kid/Genshi mess right now), so this is a request for NO ToscaWidgets > mentions under 1.0/*, including mentions as a third party plugin. Docs > should be written to apply to the current widgets only and, once we're > happy with them, copy it somewhere else (suggestions, anyone?) and > modify it to treat TW as if they are the only widgets available. TW > users can be directed to the appropriate location but TG widgets users > should not have to deal with TW topics, notes and caveats. > > We need to draw the line on documentation versioning somewhere, so > this is where I'll start. > > Regards, > Karl
I would hate to see any discouragement in creating documents for alternate components. So how about putting these documents in 1.0/AlternateComponents/pagename to minimize confusion. --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "TurboGears Docs" 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-docs?hl=en -~----------~----~----~----~------~----~------~--~---
