On 2/7/07, Kevin Horn <[EMAIL PROTECTED]> wrote: > the "Identity source" problem:
I've noticed that. The reason I haven't fixed it is because the identity docs were getting refactored (hence the note). Unfortunately, it looks like they didn't finish getting refactored, so they're on the todo list. > Other configuration docs issues: > 1) the links to the CherryPy config docs are broken I'll get that fixed tonight > 2) more detail would be nice in a few places, as I think this will be a > critical section for new users. Specific examples would be convenient. I'm too familiar with the article. Just read it over and didn't notice any holes. > 3) a mention that the config files are heavily commented might be nice, so > people could look there if they don't find what they need Will do. > 4) some of the config options list defaults, others list valid values, > others don't list anything. To use the config system people will need to > know The ones that don't list anything don't have defaults. I can probably put an explicit note to that effect. As for the rest, I see a few changes I could make, but I'd have to go over them in detail later. > Introductory paragraphs: > The current docs are somewhat inconsistent in the use of intro paragraphs on > each page. This tends to vary depending on who wrote the article. Once things start settling down, we should get more consistency here when we do editing passes. > Home link: > All pages should have a link to the home page of the wiki. Currently its > easy to get to the root of the TG version you are looking at, but not so > easy to get to another version. This isn't such a big deal yet, but will be > when 1.1 and 2.0 are released. Once we get a body of documents in those versions, I'll get the nav bar updated to link to the various versions. I'm more annoyed that clicking on the TG logo doesn't take you anywhere. Of course, I'm mostly blaming myself there because I didn't fix the page when I was redoing the templates. --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
