addons-dev

Addons Forge

Typical development workflow:

• Fork - once per person
• Clone - once per computer
• Create new branch - once per addon (or set of addons). For managers only, because push access is needed.
• Get branch from upstream - once per addon
• PR to addons-dev - as much as needed.
• Merge PR to addons-dev - as much as needed. For managers only.
• Final PR to target repo - once per addon
• After accepting Final PR, addon is published at apps store automatically with a delay of up to 24 hours
• Further updates - PRs are sent directly to target repo.

Fork

Click Fork button at top right hand corner

Clone

• Clone your fork to your machine:

    git clone git@github.com:USERNAME/addons-dev.git
  

• Add remotes

    cd addons-dev
  
    git remote add upstream          git@github.com:it-projects-llc/addons-dev.git
    git remote add misc-addons       https://github.com/it-projects-llc/misc-addons.git
    git remote add pos-addons        https://github.com/it-projects-llc/pos-addons.git
    git remote add mail-addons       https://github.com/it-projects-llc/mail-addons.git
    git remote add access-addons     https://github.com/it-projects-llc/access-addons.git
    git remote add website-addons    https://github.com/it-projects-llc/website-addons.git
    git remote add l10n-addons       https://github.com/it-projects-llc/l10n-addons.git
  

Create new branch

# specify target, repo and branch:
export REPO=misc-addons BRANCH=12.0 FEATURE=some_feature

# fetch remote
git fetch ${REPO}

# create new branch
git checkout -b ${REPO}-${BRANCH}-${FEATURE} ${REPO}/${BRANCH}

# push to upstream
git push upstream ${REPO}-${BRANCH}-${FEATURE}

# done

Get branch from upstream

# get branch from upstream
git fetch upstream misc-addons-12.0-some_feature
git checkout -b misc-addons-12.0-some_feature upstream/misc-addons-12.0-some_feature

PR to addons-dev

# work and make commits
git commit ...

# push to origin
git push origin misc-addons-11.0-some_feature

# create pull request via github interface to it-projects-llc/addons-dev repo

Final PR to target repo

# example for misc-addons
cd /path/to/misc-addons

# add remote if it doesn't exist yet
git remote add addons-dev https://github.com/it-projects-llc/addons-dev.git

# fetch remote
git fetch addons-dev misc-addons-12.0-some_feature

# create branch
git checkout -b 12.0-some-feature addons-dev/misc-addons-12.0-some_feature

# Sync with upstream
git fetch upstream
git rebase upstream/12.0

# push to your fork of target repo
git push origin 12.0-some-feature

# create PR to target repo