On 11/17/06, Lee McFadden <[EMAIL PROTECTED]> wrote: > That's our major stumbling block - documentation. There are many > people putting in a tremendous effort to get the documentation up to > scratch but more help is needed, even if it's just reading through the > existing documentation and leaving comments. Every little helps :)
IMO, the light is visible at the end of the tunnel. The two main areas missing are widgets and API docs, and I think that widgets will be taken care of over the next two weekends. For the API docs, I'd really, really appreciate it if the committers would go through and write docstrings. Alberto has written some nice docstrings for base.py in widgets and there are pieces elsewhere, but the docstring coverage is much worse than our current docs coverage. Aside from that, I only have splitting IdentityManagement into a set of smaller, more focused chunks and documenting how i18n and admi18n work on my list as "required for 1.0". There's a bit of editing and reworking for about 7 articles that are currently listed in the official docs but aren't up to snuff and I have a list of 5 articles I'd like to write, but I don't feel that any are essential. There's still a lot of stuff on Trac that hasn't been migrated. I have no desire to migrate trac docs myself (I really would rather be writing code than writing docs) and I'm hoping that someone else will pitch in and do a conversion or two. There's a listing of possible conversions on RoughDocs, so you don't even have to go digging for good articles to convert. --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
