# Development workflows
Developers will often have preferences on how they work, but it is worth highlighting different development workflows. There are at least two main strands of development to consider.
- Collaboration on the products within the open source Github organisation
- Installing, developing and deploying a site based on LocalGov Drupal or LocalGov Microsites.
# 1. Collaborating on Github
We encourage everyone to collaborate on Github to help improve the products, modules and themes we use and support. To help with this, we aim to follow a number of conventions and best practices.
- Code of conduct (opens new window)
- Contribution guidelines (opens new window)
- Git branch naming conventions (opens new window)
- Module, project and field naming conventions (opens new window)
- Reporting security issues (opens new window)
- Testing branches for pull requests (opens new window)
# 2. Building and deploying your own site(s)
Since Drupal 8, the Drupal community has benefitted from the use of composer to manage code dependencies and configration management to manage the state of a Drupal site. This has led to different approaches to building and deploying code and confugration and some challenges inherient in doning so consistenly.
Useful backgound reading:
- Confuguration management in Drupal (opens new window)
- Deployment Workflows for Drupal (opens new window)
For an example hot-to install LocalGov Drupal and deploy changes to a development site:
# Reviewing and selecting updates from a Drupal distribution or project.
Sometimes the LocalGov Drupal distribution will want to make changes in the default configiration that comes when we run the install profile. Where possible, we try not to deploy updates to configuration as we cannot assume that individual installations will have kept the original configuration. On occasions we will want to use update hooks to change active configuration. These changes will be clearly documented in release notes and will aim to avoid making changes to configration that has deviated from the original.
There are also modules that can help with reviewing and accepting configuration changes from upstram distributions and modules.