@Phil: I think that is a good idea. One person could invest some time in starting the engine to keep the community going and growing.
Anyone that is able to point out this topic to the right person in the Prototype Core team? I think that, from seeing all the posts in this topic, that it is certainly worth it to give it a try to add more tools for the community (e.g. like adding comments like in the php.net manual pages instead of a separate wiki which is not read). Regards, Sander On Tue, Jul 26, 2011 at 9:42 PM, Phil Petree <phil.pet...@gmail.com> wrote: > The core devs need to appoint a "Community Activist" whose responsibility > it is to build the community and who has the decision making authority to > implement these changes without bugging the devs with all our needs. > > > On Tue, Jul 26, 2011 at 1:42 PM, Jason <jwestbr...@gmail.com> wrote: > >> >> So based on a handful of responses - there would be a benefit to >> having "margins" - but we still need a blessing from the core devs to >> either give the right people access or to start implementing it. >> >> Any of the Prototype Devs out there? >> >> >> On Jul 25, 11:31 am, Tom Gregory <tagreg...@gmail.com> wrote: >> > Plus one from me too. >> > >> > I agree there should be an easy way for "writing in the margins" (as >> > Walter put it). I wouldn't encourage allowing those pages to be used >> > for help requests (which could get overwhelming for a reader to slog >> > through), but like the php.net docs, neat solutions and gotchas >> > related to the page's topic. Good comments could be incorporated into >> > the docs. It's a low-commitment way to encourage contributions (w/o >> > the need for git, patches, etc.) >> > >> > TAG >> > >> > On Jul 21, 9:42 pm, Walter Lee Davis <wa...@wdstudio.com> wrote: >> > >> > >> > >> > >> > >> > >> > >> > > On Jul 21, 2011, at 8:32 PM, Jason wrote: >> > >> > > > I agree with both Richard and Sander - and there might be a middle >> > > > ground >> > >> > > > I think that community comments, examples etc are a good addition to >> > > > documentation and help users that are starting out - it would also >> > > > give the new user a sense there was someplace to go for help. There >> > > > has been many times I was working with a new function and was able >> to >> > > > figure it out from the community comments instead of the "official" >> > > > documentation (no offense intended) >> > >> > > > On the other hand full blown PHP documentation like is overkill and >> is >> > > > too much too fast >> > >> > > > On the third hand - I would be more than happy to contribute to >> > > > building the community section, but I'm not sure if a PHP guru will >> be >> > > > much help (as I'm assuming its built on Ruby) >> > >> > > The current documentation (1.7) is generated directly from the source >> >> > > code using a tool written by one of the core guys -- I think it's >> > > called jsDoc or something like that. Anyway, it's just static HTML, >> > > CSS and JavaScript (naturally) once that tool is done. >> > >> > > I think that if there was enough energy for moderation, or some sort >> > > of community moderation system, that a great add-on to the site would >> >> > > be something like Disqus, so the user comments and corrections could >> > > be added to the mix. That's the thing I really love about the PHP >> > > site, and miss in other languages. It's an annotated encyclopedia that >> >> > > has lots of interesting stuff written in the margins by everyone else >> >> > > who ever used it. I can't count the number or really hard problems I >> > > was able to solve by looking at someone's example code in the >> comments. >> > >> > > Walter >> >> -- >> You received this message because you are subscribed to the Google Groups >> "Prototype & script.aculo.us" group. >> To post to this group, send email to >> prototype-scriptaculous@googlegroups.com. >> To unsubscribe from this group, send email to >> prototype-scriptaculous+unsubscr...@googlegroups.com. >> For more options, visit this group at >> http://groups.google.com/group/prototype-scriptaculous?hl=en. >> >> > -- > You received this message because you are subscribed to the Google Groups > "Prototype & script.aculo.us" group. > To post to this group, send email to > prototype-scriptaculous@googlegroups.com. > To unsubscribe from this group, send email to > prototype-scriptaculous+unsubscr...@googlegroups.com. > For more options, visit this group at > http://groups.google.com/group/prototype-scriptaculous?hl=en. > -- You received this message because you are subscribed to the Google Groups "Prototype & script.aculo.us" group. To post to this group, send email to prototype-scriptaculous@googlegroups.com. To unsubscribe from this group, send email to prototype-scriptaculous+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/prototype-scriptaculous?hl=en.
