On Mon, Jun 1, 2009 at 12:13 PM, HansD <hans.don...@pobox.com> wrote:
> > - votings needs registering (don't like that) ...it's a reddit design, to prevent one person from artificially "upping" a vote; presumably this way you can "depend" on reddit votes, and that is what it offers. > > - seeing how a simple vote ends up like this, wouldn't like to be the > documentation lead :-) ... not sure this has anything to do specifically w/ documentation, or leading it... I think this is a reddit user-interface design thing (I could talk more than I care to about that); The only real thing it has to do with documentation is what any abstract representation in human systems has: it's like a network problem, n-nodes result in n! connections; complexity explodes (and reddit has not, in this case, facilitated solving this). The rational solutions to managing explosion of complexity: - - reduce n (decays to n=1; I write my version of documentation; you comment, and I decide how to fix - like it or leave it, the complexity is thus managed thru a single point of control); - - abstract concepts, so that each appropriate abstraction becomes a node point, and thus manage complexity, and yet retain meaningful system interrelationships (interfaces) between concepts (i.e., keep the "network connections" between those n nodes). While discussions have OFTEN focused on frustration about documentation, the approaches proposed (or complaints levied) fail to address the n! problem, or the nature of what is needed. wiki, wiki syntax, while having some noticeable effect, will not solve the node explosion problem, and therefore will not do anything to solve the "lots of email posts on google group" as documentation. In fact, the groups serve well to opportunistically solve (e.g. document) those problems - albeit in a sometimes non-structured way which makes retrieval and correlation problematic, and has many other artifacts... This (and reddit "solution") is one instance, one example of a more general problem: the tendency (perhaps addictive in the way it's pursued) of diving to solution, implementation details (useful for discovery) but with rare follow throuh to a structural organization. "Good" documentation will help do this (and by "good" I mean consistent, unifying, aligned around the same abstractions; everybody building their own disparate or non-existing abstractions will only fail to address n! issue); good docstrings will encourage this; good testing framework and buildbot testing may also help some. - Yarko > > > On 1 jun, 19:08, Yarko Tymciurak <yark...@gmail.com> wrote: > > .... oops... somehow hist "send"... continuing: > > > > > > > > On Mon, Jun 1, 2009 at 11:59 AM, Yarko Tymciurak <yark...@gmail.com> > wrote: > > > hmmm ... is this a user interface problem with redditt? > > > > > I think I see MORE entries on web2py now, but not an increase in count > on > > > one: > > > > > - atryda: 1 point; "Web2py is best for me..." > > > - janhesky: 1 point: "Web2py for great GAE compatibility." > > > - child entry: > > > - turicas: 1 point: "sure, web2py is very cool..." > > > - satospeak: 1 point: "web2py of course..." > > > - csmiga: 1 point: "web2py..." > > > - mark1983: 3 points: "web2py of course..." > > > - alvinru: 3 points: "I use web2py..." > > > - zoomq > > > > - zoomq: 2 points: "web2py" (the simple, one word entry) > > - benigno: 1 point: "web2py is about..." > > - dlypka: 1 point: "web2py on App Engine..." > > - johnromero: 0 points (!): "web2py and rails" > > > > Last night we had 4 separate entries; today we have 11 SEPARATE > entries... > > > > It would be _nice_ if you could just ADD up the points, but you CAN'T (I > > voted on more than one entry last night... the problem is all the > multiple > > entires) > > > > So let's try this (again): > > > > ---> If you want to vote for web2py on redditt, please find zoomq's > entry > > and enter a vote (press the up-arrow); > > --> If you want to add comments, login and click "comment" to zoomq's > entry > > (this will at least keep them all together)... BUT be sure to vote > first... > > > > Thanks, > > - Yarko > > > > > > > > > - > > > > > On Mon, Jun 1, 2009 at 11:02 AM, Pete <wasp...@gmail.com> wrote: > > > > >> Done. > > > --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
