On Feb 9, 12:28 am, Brian M <[email protected]> wrote: > Credibility wise I should think that having what's preceived as "poor" > documentation is worse than having good documentation that just > happens to not be powered by the framework being documented.
+1 Some days ago web2py popped up on reddit where frequent comments where like: - "It is under very active development docs fall behind." - "I've considered playing with it a few times to see if I can make use of it. But I've been really turned off by the documentation" - - "same here" In the very few days, also, on this groups, those kind of topics arose: powered by drupal? http://groups.google.com/group/web2py/t/56a821400ce4dd8c?hl=en PDF manual soon available online in HTML (maybe) http://groups.google.com/group/web2py/browse_thread/thread/0ec97ec251ab1cc9?hl=en proposal for online documentation http://groups.google.com/group/web2py/browse_thread/thread/736d8b5351d6d1ec?hl=en The state of the wiki and documentation in general http://groups.google.com/group/web2py/browse_thread/thread/231fee7e4a11682d?hl=en state of documentation: why pdf? http://groups.google.com/group/web2py/browse_thread/thread/3c6c21585508eb92/b8677223a9ccd30d?hl=en all dealing with the "problem" of web2py documentation. Now, apart from Massimo, there's no voice within or outside the web2py community saying things like "the actual wiki's poor but at least it's web2py!" or "we need better documentation but only if it can be done in web2py". All the people waning to contribute documentation, or asking for it or complaining about it are focused on concepts like: - expandable (like wiki) - updated (like not pdf) - searchable (like html based) - unified (like not "sure, this is documented! just search the newsgroup or the pdf or the quick examples or the wiki or the pdf addenda or web2pyslices or the examples or the other pdf!") If web2py doesn't have (yet) a mean to provide an expandable, update, searchable, unified documentation, let's rely on something standard and consolidated with years of development behind it. The sooner the whole web2py power is accessible to anyone, the sooner someone (maybe currently turned out by the documentation itself) will exploit that knowledge to build the perfect web2py wiki / documentation software. -- 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.
