On 11/10/06, iain duncan <[EMAIL PROTECTED]> wrote: > - It seems many docs are not obviously referenced from the main doc > start page making finding some stuff hard. There needs to be a current > tree style approach to all the various elements. I personally think it > would be best if these elements focus mostly on one thing so they can be > done in any order, past the basic one of getting a site on of course.
The front page organization is in a state of flux. I had a version I liked but Fred found it confusing, so I've been letting him do his own thing with it. There are a few things I like about it and a few things I don't. We'll have to work this out so we don't get in some sort of edit war. > - versioning info is a problem right now ( I'm sure this is known ) Nothing on the docs website should be anything other than 1.0. The trac stuff is whatever, there's a lot of info on there but it really needs to die so we don't have versioning issues. > - the hardest stuff to find clear organized current docs on appears to > me to be validation ( form encode ) and after that widgets. Both those > left me in a bit of a versioning haze and required much googling. I > think a clear tutorial of making a form, adding widgets, and then adding > a validation scheme with code all aimed at 1.0 would be really useful > right now Well normally when you're using widgets you use validation with the widgets, which confuses things slightly. > - I think complete code samples that are known good for current release > would be a great addendum to all current docs This should also have happened for docs.tg.org, the trac wiki has no such constraints. > - I got very confused as to when I should be looking on Trac and when on > the doc homepage. They seem rather out of sync with each other This is why trac needs to go away. BTW, what did you wind up using for your orm? --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "TurboGears" 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?hl=en -~----------~----~----~----~------~----~------~--~---
