codeguy/php-the-right-way

This repository holds the source code for the PHP: The Right Way website, a reference guide aimed at helping PHP developers follow accepted best practices and coding standards. The actual reading experience lives at phptherightway.com, but all the content and the site structure that produces it are managed here. The site is built with Jekyll, which turns a collection of plain text and Markdown files into a static website. The guide itself is organized as a series of sections and sub-sections, each stored as a separate Markdown file in the project's posts directory. The navigation and page layout are generated automatically from those files, so contributors can add or edit content without touching the site's HTML structure. The guide exists because the PHP community has historically suffered from a shortage of credible, well-organized learning resources, especially for people new to the language. It was started by Josh Lockhart, who is also the author of the Slim Framework, a lightweight PHP web framework. The project has since grown with contributions from collaborators and the broader community. One of the more notable aspects of the project is the number of translations that have been produced. The guide is available in more than twenty languages, including Spanish, French, German, Japanese, Chinese, Arabic, Korean, Russian, and others. Each translation is maintained as a separate fork on GitHub and linked from the main site. The instructions for contributing a new translation are included in the repository. Contributors can improve the guide by forking the repository, making changes to the Markdown files, and submitting a pull request. The content follows a style guide requiring American English in the primary version, consistent indentation, line length limits, and code samples that meet PHP's PSR-1 standard. The project is released under a Creative Commons Attribution-NonCommercial-ShareAlike license.