Skip to main content

Recommended flows

Basically, we follow https://docs.github.com/en/get-started/quickstart/github-flow.

I have an unapproved add-on and want to check it out​

  1. I create an empty repository with an initial commit (just a README.md file)
  2. I install the GitHub app
  3. In the CMS, I fill in the URL of the repository in the add-on code settings
  4. I create a branch (any name) - or create an issue and branch from that
  5. I work within the branch, commit to the branch see folder structure for more information on how to structure your code
  6. On commit, I create a Pull Request and don't merge
  7. Reviewer does a code review
  8. Reviewer does a Merge to main branch (master branch) to start the deploy (or manually start the deploy)

I have an approved add-on, but I need to make a change​

  1. I create an issue that describes the change I'm going to make
  2. I create a branch from the issue or not
  3. I work within the branch, commit to the branch
  4. When I commit for review,
  5. I create a Pull Request, but I do NOT merge
  6. Reviewer will perform a code review
  7. Reviewer does a Merge to the main branch (master branch) to start the deploy (or manually start the deploy)

I have an approved add-on, but I need to hotfix​

  1. I commit to the main (master) branch
  2. In the commit message I use the prefix Hotfix:
  3. The application creates an issue where you can explain what was the reason for the hotfix
  4. The application performs a deploy (or you manually run the deploy)