We are pleased to announce that we are adopting the PHP CS Fixer project's coding standard for AtoM Release 2.7.0 onward. Effective immediately all code submissions to the AtoM qa/2.x branch need to conform to the new coding standard. The good news is that the PHP CS Fixer can automatically format your code to the coding standard via plugins for many popular code editors (Atom, NetBeans, PhpStorm, Sublime Text, Vim, VS Code) or the command line tool.
Who is affected by the change?
Any developer submitting code to the AtoM project will now need to format their code to conform with the new coding standard.
Why is the AtoM Coding Standard being changed?
The old AtoM coding standard was based on the Symfony 1.4 coding standards with a number of customizations specific to the AtoM project. Because the old coding standard was unique to the AtoM project, it had several problems:
Automatic formatting (linting) of AtoM code and automatically checking code for conformance was not practical, due to the effort required to define a custom formatting rule set,
Not being able to automate style checking lead to poor coding standard compliance, which made the AtoM code harder to read and understand,
PHP developers coming to AtoM project had to learn a new and idiosyncratic coding style,
The old coding standard documentation was incomplete.
Why the PHP CS Fixer Coding Standard?
Being highly opinionated minimizes the variation in coding style within the project and style consistency makes it easier for developers to read and understand the code,
The PHP CS Fixer project is mature, active, and popular minimizing the risk of obsolescence.
How can I ensure my code conforms to the new AtoM Coding Standard?
You received this message because you are subscribed to the Google Groups "AtoM Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ica-atom-user...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/0498adfa-bb62-4090-95e0-b37fc195819an%40googlegroups.com.