Category: documentation

Contributing to PHP: How to Contribute to PHP’s Manual

In this two-part article series, we’ll be covering how to contribute to the PHP project. This will hopefully clarify what steps need to be taken for those looking to become more involved with PHP. This first part will be covering how to contribute to PHP’s documentation, including how to request a php.net account a...

Learn PHP 7, Find out What’s New, and More

PHP 7, the next version of the world’s most popular programming language, has been released. We’d love to shoot fireworks and get drunk with our newfound power (seriously, the language is in the true big leagues now, functionality and performance-wise) but we’re sure the rest of the internet will do this for us. ...

The Importance of Writing Code That Humans Can Read

Have you ever finished a project in a single run without ever needing to look at the code again? Neither have I. When working on an older project, you probably want to spend little to no time figuring out how code works. Readable code is imperative to keep a product maintainable and to keep yourself, and your colleague...

Fast Multi-language Docs with SitePoint’s RTDSphinx-PHP

This post will guide you through getting up and running with RTDSphinx-PHP, a ReadTheDocs-friendly Sphinx based PHP documentation skeleton with sane defaults, pre-installed directives, and modified styles for optimal API and prose documentation rendering in multiple languages. For an unfinished example of the documenta...

Using Sphinx for PHP Project Documentation

I recently had the need to write proper prose-like source-code documentation for the Diffbot PHP client. Having looked at several documentation generators, and even having suggested a @prose tag for importing of related MD/reST documents into method and class descriptions, I realized there simply is no perfect solution...

Essential Tools & Libraries for Modern JavaScript Developers

Learning JavaScript is a great journey, but knowing the language and its syntax is only the beginning. Once the novice becomes a journeyman, they are confronted with a seemingly endless number of tools and libraries which are used to create, manage and maintain modern JavaScript code. Invariably, confusion strikes! As ...