BossaBox

This is the playbook for engineering-playbook

Source Control

There are many options when working with Source Control. In ISE we use AzureDevOps for private repositories and GitHub for public repositories.

Sections within Source Control

Goal

General Guidance

Consistency is important, so agree to the approach as a team before starting to code. Treat this as a design decision, so include a design proposal and review, in the same way as you would document all design decisions (see Working Agreements and Design Reviews).

Creating a new repository

When creating a new repository, the team should at least do the following

Contributing to an existing repository

When working on an existing project, git clone the repository and ensure you understand the team’s branch, merge and release strategy (e.g. through the projects CONTRIBUTING.md file).

Mixed DevOps Environments

For most engagements having a single hosted DevOps environment (i.e. Azure DevOps) is the preferred path but there are times when a mixed DevOps environment (i.e. Azure DevOps for Agile/Work item tracking & GitHub for Source Control) is needed due to customer requirements. When working in a mixed environment:

Resources