On Fri, May 8, 2009 at 8:33 PM, Yarko Tymciurak <yark...@gmail.com> wrote:
> On Fri, May 8, 2009 at 8:02 PM, Richard <richar...@gmail.com> wrote: > ....... > > (I worked on instructions / templates a bit last night, and may a little > more tonight... but probably won't have something to push until tomorrow) > > For those wondering what I'm doing w/ the docs - - work out makefile to generate all the appropriate links; - current logo (last night - what Massimo's book has; tonight / tomorrow: the simple logo from current web2py site) - Tim included numpy sphinx extensions - I'm adapting the instructions / examples to apply to web2py - Templates (headers) & examples for functions & classes, so we can update current web2py docstrings in a consistent way (project over next week for all...) - Expand todo list (add todo extension use as appropriate) At that point, I'll push for people to start contributing; After that, some "immediate" projects on the plate: - Incorporate document build in top-level Makefile - Make a "welcome" application sample document for application documentation standard (will include it's own makefile) - Extract web2py page template language, and create adapter for sphinx (so documents can use web2py templating); create a basic doc. template that looks more like web2py website. Attempt to package html.py and template.py in it's own package, and crate this as a project (and keep in sync w/ web2py, or perhaps web2py will separate an use this as a module? ... TBD...) - make a first cut of web2py specific template; include pdf generation to makefile, and a link in the template to download the pdf; - Begin non-code outline for document; - Include html and pdf in distro (but not in version control); on web2py, install doc tar-file similar to how basic apps are now (if not installed, install them). Beyond that, I think it will be useful to collect "best of" the group posts, and collect, and see if there are opportunities to consilidate topics. Also, update wiki with processing (learning from python-tech and sphinx and other methods). I have some ideas around linking wiki, and sphinx publishing... but want to see how it plays out, what ideas other people have. Regards, - Yarko --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "web2py Web Framework" group. To post to this group, send email to web2py@googlegroups.com To unsubscribe from this group, send email to web2py+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/web2py?hl=en -~----------~----~----~----~------~----~------~--~---