Skip to content

Latest commit

 

History

History
111 lines (80 loc) · 4.72 KB

CONTRIBUTING.md

File metadata and controls

111 lines (80 loc) · 4.72 KB
Raw

Contribute to Revel

This describes how developers may contribute to Revel.

Mission

Revel's mission is to provide a batteries-included framework for making large scale web application development as efficient and maintainable as possible.

The design should be configurable and modular so that it can grow with the developer. However, it should provide a wonderful un-boxing experience and default configuration that can woo new developers and make simple web apps straightforward. The framework should have an opinion about how to do all of the common tasks in web development to reduce unnecessary cognitive load.

How to Contribute

Presently there are no versioning or compatibility guarantees in place, so the contribution process is not very formal.

Discuss your idea

For the greatest chance of success, start with an email to revel-framework@googlegroups.com to discuss your contribution idea and design.

How to fork (without breaking Go import paths)

Go uses the repository URL to import packages, so forking and go-getting the forked project will not work.

Instead, this is the recommended way:

  1. Fork the project on Github
  2. In $GOPATH/src/github.com/robfig/revel, run this command (replacing $USER with your github username): $ git remote add fork git@github.com:$USER/revel.git
  3. When you want to push to your fork, do this: $ git push fork master

Gofmt your code

Set your editor to run "go fmt" every time you save so that whitespace / style comments are kept to a minimum.

Howtos:

Write a test (and maybe a benchmark)

Significant new features require tests. Besides unit tests, it is also possible to test a feature by exercising it in one of the sample apps and verifying its operation using that app's test suite. This has the added benefit of providing example code for developers to refer to.

Benchmarks are helpful but not required.

Run the tests

Typically running the main set of unit tests will be sufficient: $ go test github.com/robfig/revel

Refer to the Travis configuration for the full set of tests. They take less than a minute to run.

Document your feature

The Revel web site is hosted on Github-pages.

To develop the site locally:

# Clone a second repository and check out the branch
$ git clone git@github.com:robfig/revel.git
$ cd revel
$ git checkout gh-pages

# Run Jekyll to generate the site, and serve the result
$ jekyll --auto --pygments --no-lsi --safe test/revel &
$ python -m SimpleHTTPServer 8088

# Now load in your browser
$ open http://localhost:8088/revel

Any changes you make to the site should be reflected within a few seconds.

Potential Projects

These are outstanding feature requests, roughly ordered by priority. Additionally, there are frequently smaller feature requests or items in the issues.

  1. Better ORM support. Investigate Hood, Jet, or QBS as possible improvement over Gorp. Provide more samples (or modules) and better documentation for setting up common situations like SQL database, Mongo, LevelDB, etc.
  2. Support for other templating languages (e.g. mustache, HAML). Make TemplateLoader pluggable. Use Pongo instead of vanilla Go templates (and update the samples)
  3. Test Fixtures
  4. Coffeescript pre-processor. Could potentially use otto as a native Go method to compiling.
  5. SCSS/LESS pre-processor.
  6. GAE support. Some progress made in the 'appengine' branch -- the remaining piece is running the appengine services in development.
  7. More Form helpers (template funcs).
  8. A Mongo module (perhaps with a sample app)
  9. Easy emailer support (e.g. to email exception logs to developer, or even to email users),
  10. Deployment to OpenShift (support, documentation, etc)
  11. Deployment to Heroku (support, documentation, etc)
  12. Improve the logging situation. The configuration is a little awkward and not very powerful. Integrating something more powerful would be good. (like seelog or log4go)
  13. Cross-compilation in the "package" command.
  14. ETags, cache controls
  15. Performance tests. Overall QPS would be useful for marketing. Subsystem tests to direct optimization
  16. Authenticity tokens for CSRF protection
  17. A module or plugins for adding HTTP Basic Auth
  18. Allowing the app to hook into the source code processing step
  19. More tests for revel code