Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:40829 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 33696 invoked from network); 1 Oct 2008 20:01:35 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 1 Oct 2008 20:01:35 -0000 Authentication-Results: pb1.pair.com smtp.mail=hannes.magnusson@gmail.com; spf=pass; sender-id=pass Authentication-Results: pb1.pair.com header.from=hannes.magnusson@gmail.com; sender-id=pass; domainkeys=bad Received-SPF: pass (pb1.pair.com: domain gmail.com designates 64.233.182.187 as permitted sender) DomainKey-Status: bad X-DomainKeys: Ecelerity dk_validate implementing draft-delany-domainkeys-base-01 X-PHP-List-Original-Sender: hannes.magnusson@gmail.com X-Host-Fingerprint: 64.233.182.187 nf-out-0910.google.com Received: from [64.233.182.187] ([64.233.182.187:11972] helo=nf-out-0910.google.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id CA/80-04812-E17D3E84 for ; Wed, 01 Oct 2008 16:01:35 -0400 Received: by nf-out-0910.google.com with SMTP id b11so343666nfh.13 for ; Wed, 01 Oct 2008 13:01:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to :subject:cc:in-reply-to:mime-version:content-type :content-transfer-encoding:content-disposition:references; bh=bKdSZnHAvpmhDSDySCe4QmenajQQscvMeh+tXVKp0d0=; b=IbzBOtNFCJQDqcpdQpwQBfHl9SFS3uX5UZaOVYrk0jMCsJsLWkf4noYibT5FM+ZnBQ P8vf885GVTXHmyU+LJJ/r86Igo9kykVwTXfGNpGUJiN/Xg2DenvI/+fP30BBlwkJRNCQ MJLovRdRpt3TwDtVL/f2Z8b4g3zjo+df0VTJo= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:cc:in-reply-to:mime-version :content-type:content-transfer-encoding:content-disposition :references; b=CDmFAY/PEZ99D2rxPPajxtszkEIbhcSkBJUJPOy2rEXGrXE1QRVW+Nesw3ymK96xdH mEqxIG6OM/A4M2iSeHAsFMradj3D0lp8IH0H6j5LuzQObvSaTi8Q/NULRdUS+rXyt7x5 u1pjO+4PJvaYXl18f+KU5W708csuPVlA/VNh4= Received: by 10.103.206.12 with SMTP id i12mr6256738muq.33.1222891290905; Wed, 01 Oct 2008 13:01:30 -0700 (PDT) Received: by 10.103.179.15 with HTTP; Wed, 1 Oct 2008 13:01:30 -0700 (PDT) Message-ID: <7f3ed2c30810011301m6913588ax3086a3ab7ee0c305@mail.gmail.com> Date: Wed, 1 Oct 2008 22:01:30 +0200 To: "Brandon Savage" Cc: "Stanislav Malyshev" , "Elizabeth M Smith" , phpdoc@lists.php.net, internals@lists.php.net In-Reply-To: <124c7d520810011227w19a0efd8q9a9fc3986750b256@mail.gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <7f3ed2c30810010639q445b94b3m637ed929215d1cc6@mail.gmail.com> <49.5C.04812.F70B3E84@pb1.pair.com> <48E3BB65.9040405@zend.com> <7f3ed2c30810011206o69bf2b25h2ec38df8ffe5e47f@mail.gmail.com> <124c7d520810011227w19a0efd8q9a9fc3986750b256@mail.gmail.com> Subject: Re: [PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] [DOC] Commit messages dead? From: hannes.magnusson@gmail.com ("Hannes Magnusson") 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