3.5 KiB
Rules for apps in the official badge store
See Rules for apps in the official badge store
Packaging up your badge app
See Packaging up your badge app for submission to the store
Using git and GitHub to submit your badge app
Please ensure:
- You have a GitHub account
- You have git installed on your local computer
- You have written a badge app packaged it up and validated it
These instructions are tailored around submitting your Badge App but the general principle can be used to raise any pull request. Please keep pull requests focused on one thing only (like submission of your app), since this makes it easier to merge and test in a timely manner.
Setting up your git username and email address
Using the command line/terminal on your computer type:
git config --global user.name “username”
git config --global user.email “username@users.noreply.github.com”
Note that the username is the username you use to log into GitHub, not your profile “Name”
Main flow for contributing
It's important to follow these steps to make changes to your own copy of the emfcamp repo and then raise a pull request that will be merged into the emfcamp repo.
- Login to GitHub, go to the emfcamp/Mk4-Apps repository and click
Fork
in the top right - Using the command line/terminal on your computer type:
git clone <url to YOUR fork>
cd Mk4-Apps
git checkout master
git checkout -b my-app-name
to create a branch with your apps name- Copy your app files in their uniquely named folder into the Mk4-Apps/ directory (repo root directory)
git add .
to add all of your app files and directory to your local repogit commit -m "my-app-name badge app"
note that you can put any message in the quotesgit push origin my-app-name
to update your GitHub fork with the change- Create pull request using the GitHub UI to merge your changes from your new branch into
emfcamp/Mk4-Apps/master
- Repeat from step 4 for new other changes.
The primary thing to remember is that separate pull requests should be created for separate branches. Never create a pull request from your master
branch.
Once you have created the pull request, every new commit/push in your branch will propagate from your fork into the pull reqests in the main github/emfcamp/Mk4-Apps repo.
Updating your GitHub and local git repo
Later, you can get the changes from the emfcamp/Mk4-Apps repo into your master
branch by adding emfcamp as a git remote and
merging from it as follows:
git remote add emfcamp https://github.com/emfcamp/Mk4-Apps.git
git checkout master
git fetch emfcamp
git merge emfcamp/master
will update your local repogit push origin master
will update your fork on GitHub
Useful links
The GitHub workflow: https://guides.github.com/introduction/flow/index.html
If you need help with pull requests there are guides on GitHub here: https://help.github.com/articles/creating-a-pull-request/