more to add later.... reading PEP is suggesting more.... this will become a documentation item for developers then... We'll have to consider how to make documenting an application (without pulling in all the web2py documentation) simple this way too.
On Wed, May 6, 2009 at 10:01 AM, Yarko Tymciurak <yark...@gmail.com> wrote: > On Wed, May 6, 2009 at 9:56 AM, Yarko Tymciurak <yark...@gmail.com> wrote: > > I think I also want to add this: > >> >> - Parameters >> - Returns >> >> Dependencies > >> >> - >> - Notes >> - Examples >> - See Also >> - References >> >> > My thinking is that if you have nothing to put in one of these headings, > delete it from your docstring (but I need to read through that PEP still, > see what it says).... > > If we have the list / order standard through web2py, it should be nice, > readable. > > Dependencies - libraries, other modules, preconditions.... this (I expect) > might contain links - so links to other module's docstrings / sphinx docs I > would like to see here. > > --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---