{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Version History","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b8f7e689-888d-47e4-80bc-00f2532b8764"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Version","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Date","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Comment","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Lead Editor","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Contributors","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" 2024-07-14","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"First version","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"type":"mention","attrs":{"id":"6054b894695c39007086d744","localId":"27d0cd23-b67d-4e0a-8837-d8563f87fa14","text":"@William Sobel"}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Document Conventions","type":"text"}]},{"type":"paragraph","content":[{"text":"The following rules ","type":"text"},{"text":"MUST ","type":"text","marks":[{"type":"strong"}]},{"text":"be followed when using this document; these are taken from IETF ","type":"text"},{"text":"RFC 2119","type":"text","marks":[{"type":"link","attrs":{"href":"https://datatracker.ietf.org/doc/html/rfc2119"}}]},{"text":" (simplified):","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MUST","type":"text","marks":[{"type":"strong"}]},{"text":": This word means that the definition is an absolute requirement of the specification.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MUST NOT","type":"text","marks":[{"type":"strong"}]},{"text":": This phrase means that the definition is an absolute prohibition of the specification.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SHOULD","type":"text","marks":[{"type":"strong"}]},{"text":": This word means that there may exist valid reasons in particular circumstances to ignore a particular item, but the full implications ","type":"text"},{"text":"MUST","type":"text","marks":[{"type":"strong"}]},{"text":" be understood and carefully weighed before choosing a different course.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SHOULD NOT","type":"text","marks":[{"type":"strong"}]},{"text":": This phrase means that there may exist valid reasons in particular circumstances when the particular behavior is acceptable or even useful, but the full implications should be understood and the case carefully weighed before implementing any behavior described with this label.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MAY","type":"text","marks":[{"type":"strong"}]},{"text":": This word means that an item is truly optional. One user may choose to include the item because a particular marketplace requires it or because the vendor feels that it enhances the product","type":"text"},{"text":",","type":"text","marks":[{"type":"textColor","attrs":{"color":"#bf2600"}}]},{"text":" while another vendor may omit the same item.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Table of Contents","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"0095b8a3-61cb-4d34-b21d-61d76ff957a2"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"061c2c29-1a84-4e10-8a6f-406fa5baded6"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"The following rules govern our branching policy, including naming and association with Jira issues. All working groups are assigned a short name and referred to as the key. The keys can be found on the projects page in jira: ","type":"text"},{"text":"https://oagi.atlassian.net/jira/projects","type":"text","marks":[{"type":"link","attrs":{"href":"https://oagi.atlassian.net/jira/projects"}}]},{"text":". The branch name must reference the project key and the issue number.","type":"text"}]},{"type":"paragraph","content":[{"text":"This document will provide three methods for creating and managing branches. We will demonstrate using the command line and Atlassian’s SourceTree: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.sourcetreeapp.com"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Rules","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"One ","type":"text"},{"text":"MUST","type":"text","marks":[{"type":"strong"}]},{"text":" use one of the following formats for the branch name: ","type":"text"},{"text":"--","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"/-","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"One ","type":"text"},{"text":"MUST","type":"text","marks":[{"type":"strong"}]},{"text":" first create an issue in Jira before creating a branch. All GitHub branches ","type":"text"},{"text":"MUST","type":"text","marks":[{"type":"strong"}]},{"text":" reference a Jira issue.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every Pull Request on GitHub ","type":"text"},{"text":"MUST","type":"text","marks":[{"type":"strong"}]},{"text":" have two reviewers approve every merge.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Branches ","type":"text"},{"text":"MUST ","type":"text","marks":[{"type":"strong"}]},{"text":"be deleted after they are merged. This keeps the active branches to a minimum and removes stale branches.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Branches ","type":"text"},{"text":"MAY","type":"text","marks":[{"type":"strong"}]},{"text":" reference any Jira issue except for EPICs. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Before creating a pull request, ","type":"text"},{"text":"master","type":"text","marks":[{"type":"code"}]},{"text":" branch ","type":"text"},{"text":"MUST ","type":"text","marks":[{"type":"strong"}]},{"text":"be merged into working branch.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Continuous Integration/Continuous Deployment (CI/CD) ","type":"text"},{"text":"MUST ","type":"text","marks":[{"type":"strong"}]},{"text":"succeed before branch can be merged.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Creating Branches","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Branching from Jira","type":"text"}]},{"type":"paragraph","content":[{"text":"Jira allows you to create branches from issues. To do so, click on an issue from the default issue board and bring up the issue details.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":848,"alt":"image-20240714-175124.png","id":"e4a2eaf4-7778-4c9f-a930-840ef049d081","collection":"contentId-4591976461","type":"file","height":413}}]},{"type":"paragraph","content":[{"text":"The details show a link to the right “","type":"text"},{"text":"Create branch”","type":"text","marks":[{"type":"em"}]},{"text":" that uses the Jira GitHub integration to create a new branch on GitHub. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":832,"alt":"image-20240714-174802.png","id":"6e8caf7b-c1f6-4d9c-b7d8-32baef41d80b","collection":"contentId-4591976461","type":"file","height":553}}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"”Create branch”","type":"text","marks":[{"type":"em"}]},{"text":" link brings up this page that has a pre-formatted branch name. Note that the issue name starts with the following pattern: ","type":"text"},{"text":"--","type":"text","marks":[{"type":"code"}]},{"text":". You ","type":"text"},{"text":"MUST","type":"text","marks":[{"type":"strong"}]},{"text":" use one of the following formats for the branch name: ","type":"text"},{"text":"--","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"/-","type":"text","marks":[{"type":"code"}]},{"text":". Jira will only accept the first form. The remaining text may be edited as desired.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":579,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":579,"alt":"image-20240714-175010.png","id":"419cad9c-d6ff-4cf3-91db-61e50268b7d5","collection":"contentId-4591976461","type":"file","height":506}}]},{"type":"paragraph","content":[{"text":"In Jira the branch name must start with the pattern ","type":"text"},{"text":"--","type":"text","marks":[{"type":"code"}]},{"text":", otherwise you get the following error:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":527,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":527,"alt":"image-20240714-175629.png","id":"a8e2a951-e652-4ec6-9915-ece8cdd07828","collection":"contentId-4591976461","type":"file","height":98}}]},{"type":"paragraph","content":[{"text":"If you want to use the folder style of branch naming, you must use an external application. ","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":484,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":484,"alt":"image-20240714-180458.png","id":"5c2af4b3-e074-43e1-8c43-d1814511cad0","collection":"contentId-4591976461","type":"file","height":347}}]},{"type":"paragraph","content":[{"text":"The link from Jira will take you to the GitHub branch. You will need to select this branch in your local development environment to work on it. We will cover how to change branches using the command line and SourceTree from Atlassian. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1049,"alt":"image-20240714-180603.png","id":"7780a245-c02d-409f-a86e-fee2b37e13c4","collection":"contentId-4591976461","type":"file","height":294}}]},{"type":"paragraph","content":[{"text":"The next section will explain how to do so using other applications. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Branching from external applications","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Command line example","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":812,"alt":"image-20240714-181232.png","id":"41010197-9060-4430-bfe3-8fbeeb571897","collection":"contentId-4591976461","type":"file","height":233}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Source tree","type":"text"}]},{"type":"paragraph","content":[{"text":"Click the branch icon on the top menu bar:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":938,"alt":"image-20240714-181835.png","id":"8cd3732f-a268-4378-9dc9-76ce4848634d","collection":"contentId-4591976461","type":"file","height":474}}]},{"type":"paragraph","content":[{"text":"Create a new branch using the folder style: ","type":"text"},{"text":"/-","type":"text","marks":[{"type":"code"}]},{"text":". Paste the issue description into the text box, SourceTree will turn spaces into hyphens ","type":"text"},{"text":"-","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":482,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":482,"alt":"image-20240714-181657.png","id":"826a2826-adef-4033-bcd7-89f5642d1721","collection":"contentId-4591976461","type":"file","height":327}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The local branch is now organized into a folder, as can be seen on the left side. The folder format also works with other Git tools like Turtle, for example. It makes it easier for tool users to organize the various work from different working groups. GitHub will only display the full branch name and will not organize them into folders as the tools do. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":215,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":215,"alt":"image-20240714-182156.png","id":"b77f116b-d7f6-4a77-b2fc-7572502c183b","collection":"contentId-4591976461","type":"file","height":474}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sharing the work on GitHub","type":"text"}]},{"type":"paragraph","content":[{"text":"The branch will be local until you push the branch to GitHub. When you are ready to share the edits to the ontology, push the changes to GitHub where others can pull the branch.","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":410,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":410,"alt":"image-20240714-183103.png","id":"828e312d-163a-418b-81c1-c51fbd07be57","collection":"contentId-4591976461","type":"file","height":88}},{"type":"caption","content":[{"text":"Pushing to GitHub","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Pushing will share all the changes with the rest of the IOF and allow for collaborative development. In the next dialog box, select the branch using the left checkbox and click ","type":"text"},{"text":"“OK”","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":650,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":650,"alt":"image-20240714-182900.png","id":"c45b0fc7-3df8-4372-962d-e4dece8affba","collection":"contentId-4591976461","type":"file","height":274}},{"type":"caption","content":[{"text":"Select the Branch to Push","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Pulling and Editing a Branch on GitHub","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Command Line","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":811,"alt":"image-20240714-191407.png","id":"5bfc4f92-1c61-4468-9b6e-bee1578de024","collection":"contentId-4591976461","type":"file","height":173}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"SourceTree","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Merging changes from others' work","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Merging changes from GitHub master branch","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Creating a Pull Request","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"CICD","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reviewers","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Merging and deleting the branch","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"}],"version":1}