Style Guide

General Wording

Wording matters. If you're not sure, ask! All requirements should adhere to RFC-2119 conventions, but in the spirit of agile, understand that epics and stories (issues) are conversation starters and should be discussed within each thread, so these are subject to change. Changes in stated requirements must be highlighted within the issue.

Coding Styles

Spaces or Tabs

There exists an ongoing debate in nearly every development community for best practices. This project uses spaces with the number specified according to this programming language style guide. A .editorconfig file is included to make this less burdensome on contributors.

PHP

All PHP code should PSR-2 styling and conventions for all application code. For test code, deviations from PSR-2 are permissible in order to increase the readability of the test. A code linter will be employed for automated scanning of application code, it is a best practice to run this yourself as well.

JavaScript

As with all things in the JavaScript community, this seems an ever-moving target. This project is willing to adopt any preferred convention as long as it is consistent and can be checked with a code linter.