docker-mailserver/docs/content/how-to-contribute.md

25 lines
995 B
Markdown
Raw Normal View History

2016-04-27 21:54:08 +00:00
`docker-mailserver` is OpenSource. That means that you can contribute on enhancements, bug fixing or improving the documentation in the Wiki.
2016-04-24 15:10:27 +00:00
#### Project architecture
├── config # User: personal configurations
├── target # Developer: default server configurations
└── test # Developer: integration tests
2016-04-27 21:54:08 +00:00
#### Development Workflow
2016-04-27 22:10:25 +00:00
The development workflow is the following:
2016-04-27 21:54:08 +00:00
2016-04-27 22:10:25 +00:00
- Fork project and clone your fork
2016-04-27 21:56:55 +00:00
- Create a branch using `git checkout -b branch_name`
- Code :-)
2016-04-27 21:54:08 +00:00
- Add integration tests in `test/tests.bats`
- Use `make` to build image locally and run tests
- Document your improvements
2016-04-27 22:09:05 +00:00
- [Commit](https://help.github.com/articles/closing-issues-via-commit-messages/), push and make a pull-request
2016-04-28 07:28:52 +00:00
- Pull-request is automatically tested on Travis
- When tests are green, your branch is merged into `master`
- `master` is automatically tested on Travis
2016-04-27 21:57:11 +00:00
- Docker builds a new `latest` image
2016-04-27 21:54:08 +00:00