Contributing¶
Coding Standards¶
Falcon follows Drupal 8 Coding standards.
To check code on your local environment, run the following commands:
make code:check
- checks all PHP & Javascript code against Drupal and DrupalPractice coding standards.make code:fix
- attempts to automatically fix some of found issues in PHP & Javascript code.
Documentation¶
We’d love to have you helping with Falcon documentation.
All documentation is stored in the main Falcon repo in docs
folder. We use
reStructuredText format and readthedocs.org hosting for our documentation.
Getting started¶
You can start contributing using GitHub edit feature. All you need to do is to clone the repo, edit one of .rst files and submit PR as usual.
Haven’t used reStructuredText before? Don’t worry! Check out a couple of examples to get started.
Building on local¶
If you’d like to build Falcon docs on your local please uncomment sphinxdocs
service in docker-compose.override.yml
and run make up
.
Now all your changes in docs
folder are tracked and automatically built in
docs/_build/html
folder.