Skip to content

Instantly share code, notes, and snippets.

@135yshr
Forked from jonah-williams/readme.markdown
Last active August 29, 2015 13:56
Show Gist options
  • Select an option

  • Save 135yshr/8999201 to your computer and use it in GitHub Desktop.

Select an option

Save 135yshr/8999201 to your computer and use it in GitHub Desktop.

Project

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

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?

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

Copyright © 2011 xxxxxx Licensed under the Apache License, Version 2.0 Distributed under the MIT License. Dual licensed under the MIT license and GPL license.

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