Re: Contributing to PHP 7 Docs
| From: | Colin O'Dell | 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
>
>