Skip to content

Latest commit

 

History

History
45 lines (30 loc) · 2.51 KB

CONTRIBUTING.md

File metadata and controls

45 lines (30 loc) · 2.51 KB

Contributing to BLT

Please feel free to contribute to the project or file issues via the GitHub issue queue. When doing so, please keep the following points in mind:

  • BLT is distributed under the GPLv2 license; WITHOUT ANY WARRANTY.
  • The project maintainers make no commitment to respond to support requests, feature requests, or pull requests.
  • All contributions to BLT will be reviewed for compliance with Drupal Coding Standards and best practices as defined by the project maintainer.
  • Feature that are part of the Road Map will be prioritized for inclusion.

BLT work is currently being tracked in the BLT GitHub issue queue and organized via a Waffle.io Kanban Board.

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
cp -R blt/blt-project .
cd blt-project
composer install
./vendor/acquia/blt/blt.sh install-alias
blt init
blt configure
composer update

The new blt-project 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 blt-project/vendor/acquia/blt.

Development conventions

Phing targets vs. Symfony commands?

While Phing and the Symfony Console can both accomplish some of the same tasks, they are different tools with different intended purposes. When developing functionality for BLT we are careful to choose the right tool for the right job.

Phing is intended to be build tool. It is particularly good at stringing together multiple commands and tasks into a single target which can then be executed procedurally. We use Phing when are requirements are well suited to this strength.

The commands that Phing executes can, of course, be provided by anything. Some are native linux commands, some are provided by tools like Composer and NPM, while others may be provided by the Symfony Console component.

As a rule, we use Symfony console to provide fixed-scope commands. These commands should be flexible and have absolutely no intrinsic awareness of the greater build process. We use Phing to call commands within the context of a build process, executing them with specific argument values at the correct time.