Menu
▾
▴
Re: [Plone-docs] Let's turn off api.plone.org.
|
From: Alex C. <ac...@ac...> - 2009-08-19 17:56:49
|
On 2009-08-19, David Hostetler <neg...@gm...> wrote: > --===============8092464424708246308== > Content-Type: multipart/alternative; boundary=00163645705e9d43f80471810811 > > --00163645705e9d43f80471810811 > Content-Type: text/plain; charset=UTF-8 > Content-Transfer-Encoding: 7bit > > grep -Rl "def <method name>" * Yeah, the problem we are facing now (IMO) is api.plone.org is useful for folks like Carsten that can use it as a "grep-like" tool (via google searches, I assume), but otherwise not very useful and more importantly confusing to new people (i.e. the "OMG! Plone is a monster!" reaction.) So, like David says, I would suggest developers use a filesystem grep to (almost as easily) get the same information, and we spare new people the confusion. In the future, I'd love to see something like: http://apidoc.zope.org/++apidoc++/ available for Plone, but I'm not sure what the likelyhood of that is (I believe Philikon told me once that it could *probably* be easily implemented in Five, but has not been yet.) > If there's a more efficient way I'll adopt it in a heartbeat. > > On Wed, Aug 19, 2009 at 12:16, Carsten Senger <se...@re...> wrote: > >> Hi Alex, >> >> --On Mittwoch, August 19, 2009 15:48:02 +0000 Alex Clark >> <ac...@ac...> wrote: >> >> > So I'd suggest we turn it off and end the confusion for good! Thoughts? >> >> I use it regulary as a fast way to grep for a method cause it shows me >> where the method is inherited from. I'm ok with turning it off as it isn't >> usefull as api documentation. But I like to hear how other people find the >> source of a method without jumping through many source files. >> >> ..Carsten >> >> > > --00163645705e9d43f80471810811 > Content-Type: text/html; charset=UTF-8 > Content-Transfer-Encoding: quoted-printable > ><br>grep -Rl "def <method name>" *<br><br>If there's a = > more efficient way I'll adopt it in a heartbeat.<br><br><div class=3D"g= > mail_quote">On Wed, Aug 19, 2009 at 12:16, Carsten Senger <span dir=3D"ltr"= >><<a href=3D"mailto:se...@re...">se...@re...</a>></span= >> wrote:<br> > ><blockquote class=3D"gmail_quote" style=3D"border-left: 1px solid rgb(204, = > 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">Hi Alex,<br> ><br> > --On Mittwoch, August 19, 2009 15:48:02 +0000 Alex Clark<br> ><div class=3D"im"><<a href=3D"mailto:ac...@ac...">acl...@pu...= > t</a>> wrote:<br> ><br> > > So I'd suggest we turn it off and end the confusion for good! Thou= > ghts?<br> ><br> ></div>I use it regulary as a fast way to grep for a method cause it shows m= > e<br> > where the method is inherited from. I'm ok with turning it off as it is= > n't<br> > usefull as api documentation. But I like to hear how other people find the<= > br> > source of a method without jumping through many source files.<br> ><font color=3D"#888888"><br> > ..Carsten<br> ></font><div><div></div><br></div></blockquote></div><br> > > --00163645705e9d43f80471810811-- > > > --===============8092464424708246308== > Content-Type: text/plain; charset="us-ascii" > MIME-Version: 1.0 > Content-Transfer-Encoding: 7bit > Content-Disposition: inline > > ------------------------------------------------------------------------------ > Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day > trial. Simplify your report design, integration and deployment - and focus on > what you do best, core application coding. Discover what's new with > Crystal Reports now. http://p.sf.net/sfu/bobj-july > --===============8092464424708246308== > Content-Type: text/plain; charset="us-ascii" > MIME-Version: 1.0 > Content-Transfer-Encoding: 7bit > Content-Disposition: inline > > _______________________________________________ > Plone-docs mailing list > Plo...@li... > https://lists.sourceforge.net/lists/listinfo/plone-docs > > --===============8092464424708246308==-- > > -- Alex Clark · http://aclark.net Buy Practical Plone 3: http://tinyurl.com/practical-plone |