Newsgroups: php.doc,php.internals Path: news.php.net Xref: news.php.net php.doc:969379449 php.internals:40830 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 38322 invoked from network); 1 Oct 2008 20:04:48 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 1 Oct 2008 20:04:48 -0000 Authentication-Results: pb1.pair.com header.from=brandon@brandonsavage.net; sender-id=unknown Authentication-Results: pb1.pair.com smtp.mail=brandon@brandonsavage.net; spf=permerror; sender-id=unknown Received-SPF: error (pb1.pair.com: domain brandonsavage.net from 64.233.182.190 cause and error) X-PHP-List-Original-Sender: brandon@brandonsavage.net X-Host-Fingerprint: 64.233.182.190 nf-out-0910.google.com Received: from [64.233.182.190] ([64.233.182.190:16535] helo=nf-out-0910.google.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id F8/91-04812-CD7D3E84 for ; Wed, 01 Oct 2008 16:04:46 -0400 Received: by nf-out-0910.google.com with SMTP id b11so344503nfh.13 for ; Wed, 01 Oct 2008 13:04:40 -0700 (PDT) Received: by 10.86.52.6 with SMTP id z6mr7708578fgz.48.1222891480285; Wed, 01 Oct 2008 13:04:40 -0700 (PDT) Received: by 10.86.33.12 with HTTP; Wed, 1 Oct 2008 13:04:40 -0700 (PDT) Message-ID: <124c7d520810011304i4b2c7dday534c4da9f0ec2e79@mail.gmail.com> Date: Wed, 1 Oct 2008 16:04:40 -0400 To: "Hannes Magnusson" Cc: "Stanislav Malyshev" , "Elizabeth M Smith" , phpdoc@lists.php.net, internals@lists.php.net In-Reply-To: <7f3ed2c30810011301m6913588ax3086a3ab7ee0c305@mail.gmail.com> MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="----=_Part_18236_22901486.1222891480270" References: <7f3ed2c30810010639q445b94b3m637ed929215d1cc6@mail.gmail.com> <49.5C.04812.F70B3E84@pb1.pair.com> <48E3BB65.9040405@zend.com> <7f3ed2c30810011206o69bf2b25h2ec38df8ffe5e47f@mail.gmail.com> <124c7d520810011227w19a0efd8q9a9fc3986750b256@mail.gmail.com> <7f3ed2c30810011301m6913588ax3086a3ab7ee0c305@mail.gmail.com> Subject: Re: [PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] [DOC] Commit messages dead? From: brandon@brandonsavage.net ("Brandon Savage") ------=_Part_18236_22901486.1222891480270 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline I'd be happy to serve as your test subject. I'll post back here when I've done it (sometime this evening once I'm home from the office). Brandon On Wed, Oct 1, 2008 at 4:01 PM, Hannes Magnusson wrote: > On Wed, Oct 1, 2008 at 21:27, Brandon Savage > wrote: > > All, > > > > I am what I guess you'd call a "newbie" - Elizabeth got me on this list > > during ZendCon and though I've been following it I still have no idea how > > the doc editing process works. I'm exactly who you want this kind of tool > > for - a new contributor who is eager to contribute but unsure about how > to > > do so. > > Would you mind being my test-subject then? :) 15minutes of your time > (plus couple of minutes to reply back) is all I ask for. > Its an easy task: Document the LogicException exception. > > The exception has no methods (except for inherited once) and how to > document exception (from a-z, everything from obtaining the source to > building them to actually creating the doc) is already documented at > http://doc.php.net/php/dochowto/article.thequicky.exceptions.php > > If it takes more then 15minutes you can quit and we'll have to try to > find better ways. If however you manage to do it in 15minutes or less, > please post the file to phpdoc@lists.php.net. > > -Hannes > ------=_Part_18236_22901486.1222891480270--