Skip to content


Browse files Browse the repository at this point in the history
add contribution file as part of community guidelines
  • Loading branch information
nilslice committed Jun 21, 2017
1 parent f4c5d79 commit 9edce7d
Showing 1 changed file with 51 additions and 0 deletions.
51 changes: 51 additions & 0 deletions
@@ -0,0 +1,51 @@
## Contributing

1. Checkout branch ponzu-dev
2. Make code changes
3. Test changes to ponzu-dev branch
- make a commit to ponzu-dev
- to manually test, you will need to use a new copy (ponzu new path/to/code), but pass the --dev flag so that ponzu generates a new copy from the ponzu-dev branch, not master by default (i.e. `$ponzu new --dev /path/to/code`)
- build and run with $ ponzu build and $ ponzu run
4. To add back to master:
- first push to origin ponzu-dev
- create a pull request
- will then be merged into master

_A typical contribution workflow might look like:_
# clone the repository and checkout ponzu-dev
$ git clone path/to/local/ponzu # (or your fork)
$ git checkout ponzu-dev
# install ponzu with go get or from your own local path
$ go get
# or
$ cd /path/to/local/ponzu
$ go install ./...
# edit files, add features, etc
$ git add -A
$ git commit -m 'edited files, added features, etc'
# now you need to test the feature.. make a new ponzu project, but pass --dev flag
$ ponzu new --dev /path/to/new/project # will create $GOPATH/src/path/to/new/project
# build & run ponzu from the new project directory
$ cd /path/to/new/project
$ ponzu build && ponzu run
# push to your origin:ponzu-dev branch and create a PR at ponzu-cms/ponzu
$ git push origin ponzu-dev
# ... go to and create a PR

**Note:** if you intend to work on your own fork and contribute from it, you will
need to also pass `--fork=path/to/your/fork` (using OS-standard filepath structure),
where `path/to/your/fork` _must_ be within `$GOPATH/src`, and you are working from a branch
called `ponzu-dev`.

For example:
# ($GOPATH/src is implied in the fork path, do not add it yourself)
$ ponzu new --dev /path/to/new/project

0 comments on commit 9edce7d

Please sign in to comment.