On 11/8/06, Christopher Arndt <[EMAIL PROTECTED]> wrote: > > Jorge Vargas schrieb: > > On 11/7/06, Lord Galrion <[EMAIL PROTECTED]> wrote: > >> Also, I do have a request and would be willing to help. TG docs seem > >> to be very unorganized on the website. Some are in the documantation, > >> some are in Trac and If there was one page to sum that all up, or at > >> least point people to trac > > I believe your refering to docs.turbogears.org vrs > > trac.turbogears/wiki, if you take a look the wiki is closed and on the > > front page it tells you to go to docs site. > > I have to support Lord's general sentiments here. I didn't realise that the > Trac site was closed for editing, until I tried to update a page, I had > written > earlier. The little sentence on the Trac start page is hardly enough to make > anyone aware of the fact. I suggest putting a BIG NOTE there, saying "Go to > docs.turbogears.org, anything you find here but not there, please migrate!" > > The same note should be on the DocumentationPlayground page, because many > people (like me) will have only this page in their bookmarks. > yes that's true I'll follow up on upgrading this.
> > if you find anything on > > trac that's interesting, please contribute migrating it to > > http://docs.turbogears.org/1.0/RoughDocs except for outdated docs most > > stuff should be already duplicated on the docs site. > > That may be, but the wiki is poorly linked at the present stage. For example > "IntroductionToWidgets" is not linked by any page at all, IMHO it should be > linked from the 1.0 index page directly. > I guess we don't have a lot of wiki masters around :) but please fell free to comment/modify any page there. > As a side note: http://trac.turbogears.org/turbogears/wiki/SimpleWidgetForm > should really be in the new docs wiki as well, so far it is only linked. > that's pending for migration I have added to http://docs.turbogears.org/1.0/RoughDocs/DocumentationWishList I'm trying to put in there everything I find people need/want so it's a good place to start if you want to contribute. > > http://docs.turbogears.org/1.0/RoughDocs > > This should be linked from > > - the FrontPage > - http://docs.turbogears.org/1.0 and it is at the bottom > - (it is mentioned there, but not linked) true I'll fix that > > Another side note: On the front page, the sentence "You can help us have great > docs." is hardly clear and encouraging. I would suggest something along the > lines of: > > "Do you have comments or suggestions or want to contribute to the > documentation > in any way? Please read our [http://docs.turbogears.org/DocHelp Contributing > Docs to TurboGears Guide]!" > > I am not saying, that the new doc site is all bad, and I am not expecting Rome > to be built in one day and only by the core editors, but to claim that the new > docs are satisfactory is IMHO unjustified. > This has never been the case since the early 0.9 days docs has been our biggest bug > Just my 2 cents worth > > Chris > > > > --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
