Contributing to BLT¶
Please note the branch statuses documented in the README and GitHub page: - Pull requests for enhancements will only be accepted for the active development branch. - Pull requests for bug fixes will only be accepted for supported branches.
Developing BLT locally¶
If you'd like to contribute by actively developing BLT, we suggest that you clone BLT and also created a BLT-ed project for testing your changes.
Use the following commands to create a testable BLT-created project alongside BLT
git clone https://github.com/acquia/blt.git rm -rf blted8 composer install --working-dir=blt cd blt ./vendor/bin/robo create:from-symlink
Important While you do not have to have Ansible installed on your host machine in order to use blt, in order to boot the vm within the blted8 project which the above command creates, you will need Ansible installed on your host.
blted8 directory will have a composer dependency on your local clone of BLT via a
../blt symlink. You can therefore make changes to files in
blt and see them immediately reflected in
To execute the same "release" testing that is performed during CI execution, run:
Submitting Pull Requests¶
Changes should be submitted as Github Pull Requests to the project repository. To help with review, pull requests are expected to adhere to two main guidelines:
- PRs should be atomic and targeted at a single issue rather than broad-scope.
- PRs are expected to follow the template defined by the project in