Also, the ones who complain about the documentation, are not knowledgeable enough in web2py to write documentation. The ones who are knowledgeable enough in web2py are too busy (either with web2py or real world) to write documentation.
I cannot stress enough the fact that any and all contributors (including Massimo) needs to start documenting as you go, put it in the source code, put it on the wiki. As long as the information is there then english majors can come along and format the docs correctly and in a logical manner. We need to write documentation on how we are going to document web2py!!!! A page needs to be added to the wiki, that will be a complete structured document of how web2py will be documented, including coding style, doctest style, and wikidoc style. We don't need a non-web2py based system, we have web2py wiki system that can do all that we need, we just need to use it. -Thadeus On Mon, Feb 8, 2010 at 11:54 AM, Thadeus Burgess <[email protected]> wrote: > the problem with pdf is it is not searchable. > > Take a look at http://www.cubicweb.org/doc/en/index.html > > That is nice, its in a tutorial style format, but it is a wiki so it > supports contextual searching via google. > > Its not all that special just a basic wiki where the pages are linked > together in order. > > -Thadeus > > > > > > On Mon, Feb 8, 2010 at 11:07 AM, Jonathan Lundell <[email protected]> wrote: >> On Feb 8, 2010, at 8:43 AM, DenesL wrote: >> >>> On Feb 8, 11:33 am, mdipierro <[email protected]> wrote: >>>> I am considering posting most of the book on line in HTML. This may be >>> +1000! >>>> possible with a disclaimer about "do not reproduce in print". The main >>>> issue is that the book is in latex and not easy to convert. >>> No latex to HTML conversion tools?. >> >> I investigated that a couple of years ago for an online journal. There are >> tools, but (at least at the time) they were not very good, and not >> maintained. So we gave up and stuck with pdf. >> >> How about a restricted-use PDF? >> >> -- >> You received this message because you are subscribed to the Google Groups >> "web2py-users" 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/web2py?hl=en. >> >> > -- You received this message because you are subscribed to the Google Groups "web2py-users" 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/web2py?hl=en.
