Skip to content

Instantly share code, notes, and snippets.

@ryu1
Last active August 29, 2015 14:01
Show Gist options
  • Save ryu1/23ccbd00221cd2560a14 to your computer and use it in GitHub Desktop.
Save ryu1/23ccbd00221cd2560a14 to your computer and use it in GitHub Desktop.

Project

Description: What does this project do and who does it serve?_

Requirements

Project Setup

How do I, as a developer, start working on the project?

  1. What dependencies does it have (where are they expressed) and how do I install them?
  2. How can I see the project working before I change anything?

Usage

TODO: Write usage instructions

Testing

How do I run the project's automated tests?

Unit Tests

  1. rake spec

Integration Tests

  1. Run other local services / provide credentials for external services.
  2. rake spec:integration

Deploying

How to setup the deployment environment

  • Required heroku addons, packages, or chef recipes.
  • Required environment variables or credentials not included in git.
  • Monitoring services and logging.

How to deploy

Troubleshooting & Useful Tools

Examples of common tasks

e.g.

  • How to make curl requests while authenticated via oauth.
  • How to monitor background jobs.
  • How to run the app through a proxy.

Contributing changes

  • Internal git workflow
  • Pull request guidelines
  • Tracker project
  • Google group
  • irc channel
  • "Please open github issues"

License

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment