Re: Contributing to PHP 7 Docs

From: Date: Tue, 08 Sep 2015 01:15:15 +0000
Subject: Re: Contributing to PHP 7 Docs
References: 1 2  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969385881@lists.php.net to get a copy of this message
Thanks Peter! I've just completed documenting the IntlChar class and have committed it (revision #337779). I tried to emulate existing docs as best as possible. I look forward to any feedback you guys might have :) Regards, Colin On Mon, Sep 7, 2015 at 4:50 AM Peter Cowburn <petercowburn@gmail.com> wrote: > Hi Colin! > > On 7 September 2015 at 03:01, Colin O'Dell <colinodell@gmail.com> wrote: > >> Hello everyone, >> >> My name is Colin O'Dell and I'm currently writing an e-book on the new >> features and changes coming in PHP 7 (www.leanpub.com/php7). I'll also >> be giving a crash course on PHP 7 at the php[world] conference in November. >> >> The PHP 7 research/learning process has been immensely educational for me >> - I've consumed every RFC, blog post, and tutorial out there, as well as >> testing the new features myself using Zend's nightly builds. The docs are >> usually my first stop for PHP information, but I've found several features >> which simply aren't documented yet. I'd therefore like to help contribute >> some of the knowledge I've attained back into the official docs. >> >> I've got a local mirror of the php.net site running in order to test and >> preview my edits. Everything seems to be validating and building just fine >> - I get the happy ASCII cat and my changes are reflected in the resulting >> PHP. >> >> I've already started working on the IntlChar docs - I've got about 10 >> functions done so far. My goals are to complete the IntlChar docs and then >> circle back to other PHP 7 features which still require documentation (the >> *session_start* options come to mind). >> >> Here are some screenshots showing my edits (and proving that I've got the >> build system working): >> >> - >> >> https://dl.dropboxusercontent.com/u/449877/ShareX/2015/09/2015-09-06_21-49-03.png >> - >> >> https://dl.dropboxusercontent.com/u/449877/ShareX/2015/09/2015-09-06_21-47-38.png >> - >> >> https://dl.dropboxusercontent.com/u/449877/ShareX/2015/09/2015-09-06_21-48-17.png >> >> I'd prefer to use version control to commit and push these changes up for >> review. While the web interface seems nice for simple edits, it seems >> cumbersome for making a large number of changes. >> >> *I would therefore like to request VCS access in order to push these >> edits.* I will submit a corresponding request via the >> http://php.net/git-php.php form momentarily. >> > > I have approved your VCS account, and granted you with the necessary karma > to commit your docs patches. When you push changes, there'll be a bunch of > eyes happy to look over them and provide feedback if needed. > > >> >> Please let me know if you have any questions or feedback for me. I'd >> also be happy to provide more information about myself and my programming >> background if desired. >> > > Likewise, if you have any questions do feel free to mail us. > > >> >> Regards, >> >> Colin O'Dell >> colinodell@gmail.com >> > > Cheers, > > Peter > >

« previous php.doc (#969385881) next »