sfgov

Set up Lando for local development

1. Prerequisites

• Lando
• composer
• github personal access token (https://github.com/settings/tokens)
• pantheon machine token (https://pantheon.io/docs/machine-tokens/)

2. Init Lando with Github
   lando init github --recipe=pantheon
3. composer install
4. lando start
5. (optional) Turn off caching. Turn on debug. (https://www.drupal.org/node/2598914)
   Note: Run lando drush cr instead of drush cr in step 7.

Pull Request Workflow

(https://pantheon.io/docs/guides/build-tools/new-pr/) (https://gist.github.com/Chaser324/ce0505fbed06b947d962)
(https://www.atlassian.com/git/tutorials/making-a-pull-request)
TLDR version:

1. Fork the repo
2. Create a branch and make changes on your fork. Push branch.
3. Open a pull request.
4. The team reviews, discusses, and makes change requests to the change
5. Change is approved and merged

Keep your fork up to date

1. Set upstream of fork git remote add upstream git@github.com:SFDigitalServices/sfgov.git
2. Fetch from upstream git fetch upstream
3. Switch to master git checkout master
4. Merge upstream's master into fork master git merge upstream\master

Adding a contrib module

1. Create a new branch git clone -b new_branch
2. Install module with composer composer require drupal/paragraphs
3. Enable the module lando drush -y en paragraphs
4. Export config lando drush -y cex
5. Check in modified composer and config files git add composer.* config/*
6. Commit and push changes git commit -m 'installed paragraphs' && git push
7. Wait for CircleCI to build and deploy to a multidev. CircleCI will add comment to the checkin on GitHub with link to the created MultiDev.
8. Create Pull Request and merge to master
9. Switch away from branch and delete branch git checkout master && git push origin --delete new_branch && git branch -d new_branch