1.8 KiB

Raw Blame History

Contributing

docker-mailserver is OpenSource. That means that you can contribute on enhancements, bug fixing or improving the documentation in the Wiki.

Open an issue

When opening an issue, please provide details use case to let the community reproduce your problem. Please start the mail server with env DMS_DEBUG=1 and paste the ouput into the issue.

Pull Requests

Project architecture

├── config                    # User: personal configurations
├── target                    # Developer: default server configuration, used when building the image
└── test                      # Developer: integration tests to check that everything keeps working

Submit a Pull-Request

You want to add a feature? Feel free to start creating an issue explaining what you want to do and how you're thinking doing it. Other users may have the same need and collaboration may lead to better results.

The development workflow is the following:

Fork project and clone your fork
Create a branch using git checkout -b branch_name (you can use issue-xxx if fixing an existing issue)
Run git submodule init and git submodule update to get the BATS submodules
Code :-)
Add integration tests in test/tests.bats
Use make clean all to build image locally and run tests Note that tests work on Linux only; they hang on Mac and Windows.
Document your improvements in README.md or Wiki depending on content
Commit, push and make a pull-request
Pull-request is automatically tested on Travis
When tests are green, a review may be done
When changed are validated, your branch is merged into master
master is automatically tested on Travis
Docker builds a new latest image