Sometimes you may want to connect a Pull Request (PR) and an existing GitHub issue, but do not want merging that PR to your default branch to close the referenced issue. In this case, you can use Waffle’s “Connect” keywords.
Waffle will connect your PR Issue to a referenced GitHub Issue that has the following keywords in front of the issue reference:
- connect to
- connects to
- connected to
If you use the “Connect” keywords, Waffle will move the referenced issue and it’s connected PR to your “Work Started" column (see which column on your board is assigned as "Work Started" in Project Settings>Columns). Instead of the PR Issue appearing as a separate card on your board, the PR Issue will be nested beneath, or "connected to" the referenced GitHub Issue.
Waffle will also assign the referenced issue to the pull request creator automatically.
Example: If your Pull Request description for PR#19 was "This work connects to #34", this would result in PR#19 being visually connected underneath issue #34. The connected Issue + PR would move, as a single unit, to your "Work started" column and would be assigned to the creator of the pull request.