dev howtos: getting started

How to get started developing

We are provisionally planning to use this repo and http://pagodabox.com for testing. Here's how to get started.

Get some accounts

1. Sign up for a github account at: https://github.com/signup
2. Sign up for a Pagoda Box account at: https://dashboard.pagodabox.com/account/register. (Note: don't choose "Login with GitHub" --- it doesn't do what you want. While we haven't tried it, we suspect that the other external service logins won't work any better. Create a brand new account at Pagoda Box itself.)

Fork a repository

1. Login to github
2. Browse to the main buttonmen repository: https://github.com/buttonmen-dev/buttonmen
3. Click the "Fork" button, and follow the instructions. For convenience, name your primary fork "buttonmen" also, so it will show up at: https://github.com/$yourusername/buttonmen

Setup an (empty) application at Pagoda Box

1. Login to Pagoda Box
2. At https://dashboard.pagodabox.com/, click "Start New Application":

• How to start: Empty repo
• Name: $yourusername-buttonmen
• Launch

3. On the dashboard page where you are now, you'll find a place to upload an SSH public key. Create a new key if you need to, or upload an existing one. (This is the key which you'll use to push from your local git clone to the shared repo, so the private key should be on the machine where you are doing your development, e.g. your desktop or laptop.)
4. Go to the admin options for your pagoda repo: https://dashboard.pagodabox.com/apps/$yourusername-buttonmen/edit
5. Enable SSH login and set a password. ''This will allow you to SSH into $yourusername-buttonmen@pagodabox.com and look at your PHP and Apache error logs.''

Setup your git development environment

Do all of this on your desktop or laptop, or wherever you will be doing local development.

1. Clone a copy of your forked repository:

username=<your username>
git clone https://github.com/$username/buttonmen.git

2. Add the primary fork as a git remote named "upstream", so you'll be able to merge in other people's changes:

git remote add upstream https://github.com/buttonmen-dev/buttonmen.git
git fetch upstream
git merge upstream/master

3. Add the pagoda repository as a git remote named "pagoda", so you can push to your Pagoda Box to test your code:

git remote add pagoda git@git.pagodabox.com:cgolubi1-buttonmen.git

Test pushing your code

Whenever you want to push code, do this:

1. Make any changes you want, and commit them:

git commit ...

2. Push the changes to pagoda:

git push pagoda master

You will be prompted for your SSH passphrase. Once you enter it, the commit should succeed, and pagoda should automatically start initializing your box. This should look something like:

_______________________
BUILDING INFRASTRUCTURE
"""""""""""""""""""""""
  +> Init submodules

Once it's done, you can browse to http://$yourusername-buttonmen.pagodabox.com, and look at your dev site.