Re: Joining the doc team

Hi Jamie, See inline responses. On 16 April 2015 at 13:33, Jamie Hannaford <jamie.hannaford@rackspace.com> wrote: > Hi folks, > > I'm really interested in joining the effort to work on PHP's > documentation. I think having great documentation is one of the most > important things towards improving how developers engage with a tool or > language, so I want to improve them in whatever way I can. > Fantastic, there is a lot to improve. Particularly, with the coming of PHP 7 soon! > > I have two immediate questions: > > 1. On http://doc.php.net/tutorial/joining.php, a reference is > made > towards landing a first patch on the Online Documentation Editor. Shall I > just pick something that needs work and submit a patch? > Absolutely, go for it. It's a way for you to get an idea of how we do the documentation, and for us to see if you can do it. > > 2. Is there a specific reason why SVN is used over git and Github? > Two main ones, and a cop-out. First, the editor is tied in to our SVN workflow and it hasn't been made completely Git-ready as yet. Second, we still use some SVN features that we haven't found a replacement for, or decided to drop, in Git. Finally, what we have works for us. To be honest, I use Git for my docs locally (via git-svn) to take some advantage of its features. Any questions on what to do, where to go, etc.? Do feel free to ask here or in the #php.doc channel on efnet IRC. > > Jamie > > ________________________________ > Rackspace International GmbH a company registered in the Canton of Zurich, > Switzerland (company identification number CH-020.4.047.077-1) whose > registered office is at Pfingstweidstrasse 60, 8005 Zurich, Switzerland. > Rackspace International GmbH privacy policy can be viewed at > www.rackspace.co.uk/legal/swiss-privacy-policy - This e-mail message may > contain confidential or privileged information intended for the recipient. > Any dissemination, distribution or copying of the enclosed material is > prohibited. If you receive this transmission in error, please notify us > immediately by e-mail at abuse@rackspace.com and delete the original > message. Your cooperation is appreciated. >