README-GIT.md

Pi Engine Github Usage

Notes:

• upstream: Pi Engine Repo at https://github.com/pi-engine/pi
• origin or your repo: the repo you create by forking Pi Engine at https://github.com/<your-account>/pi
• local repo: the working repo you clone from your repo

Checkout from Pi Engine project (readonly)

• git clone git://github.com/pig-engine/pi

Make a new fork

• Fork from Pi Engine Repo following

Working with forked repo

• Checkout code to local computer as working repo: git clone https://github.com/<your-account>/pi
• Working with commits
  • Synchronize code from your repo: git pull or git fetch
  • Add local changes: git add --all
  • Commit local changes: git commit -a -m 'Commit log message.'
  • Push commits to your repo: git push
• Working with branches
  • Check local branches: git branch
  • Create a local branch: git branch -a <new-branch>
  • Push a local branch to your repo: git push
  • Swtich to a branch: git checkout <another-branch>
  • Merge code from another branch: git merge <another-branch>
  • Delete a local branch: git branch -d <old-branch>
  • Delete a branch from your repo: git push origin :<old-branch>
• Working with tags
  • Check local branches: git tag
  • Create a local branch: git tag -a <new-tag>
  • Push local tags to your repo: git push --tags
  • Delete a local branch: git tag -d <old-tag>
  • Delete a tag from your repo: git push origin :<old-tag>

Working with upstream repo

• Add Pi Engine Repo as upstream: git remote add upstream https://github.com/pi-engine/pi.git
• Fetch changes from Pi Engine Repo: git fetch upstream
• Merge Pi Engine changes into local repo: git merge upstream/<branch-name>
• Synchronize your repo with Pi Engine Repo: git merge upstream/<branch-name> + git push origin <branch-name>

Pi Engine Github Skeleton

Pi Engine Core

• pi-engine/pi: Pi Engine core repo
  • [branch/master] (https://github.com/pi-engine/pi): Stable code in development
  • [branch/develop] (https://github.com/pi-engine/pi/tree/develop): Code in active development
  • [tag/release-{20130314}] (https://github.com/pi-engine/pi/tree/release-pi-day): Release tags
• pi-engine/pi/wiki: Pi Engine documents

Pi Engine Module

• pi-module: repos for modules
• Eeach module has its own repo, for instance pi-module/tag for module tag

Pi Engine Theme

• pi-theme: repos for themes
• Each theme has its ownrepo, for instance pi-theme/pi for theme pi

Pi Engine Asset

• pi-asset: repos for assets: images, pdfs/files, videos, etc.

Pi Engine Extras

• pi-extra: repos for extra components