Development Process
*******************

We need to develop not just for ourselves, but for those who follow
us. This means following good development process to provide
transparency, maintainability and readability to what we're doing.


Coding Style
============

* Unix style: LF line endings.

* No trailing spaces.

* No tabs: use 4 spaces instead.

* Bracketing style: use the style that's already there.

* You are not a compiler: code for readability, not compactness.

* We are open source: coding security-by-obscurity is not necessary.
  Use semantically sensible function and variable names.

* Comments. More comments. Still more comments. Nobody will know what
  your brilliant idea was when you wrote that gnarly piece of code
  unless you tell them.

* Commit messages. Commit discrete changes, don't munge six different
  fixes into a single commit. And provide a clear message (preferably
  tied into a GitHub issue) of what problem these changes address.


Making changes
==============


Before you begin
----------------

Found a bug? Got an enhancement? Great!

New Feature considerations: this is an open source project. If your
change isn't a basic part of what is already planned, will you be
around to support it? Can you justify why it's in the best interests
of the project to have your change included? We'd love to talk it
through with you: contact us via the mailing lists.


Using GitHub
------------

First, check out our Guide to GitHub, which covers:

1. Create a GitHub account.

2. Fork the repository.

3. Clone the fork.

4. Branch the clone.

From there, you:

1. Take ownership of a GitHub issue (or create a new one to cover what
   you're planning to do).

2. Code code test test test code code test test test.

3. Use git to commit your changes.

4. Issue a pull request on GitHub.

5. Wait for review (a quick note to the mailing list can speed this
   along).

6. Once approved, it'll be merged into the master.


Patches through the mailing list
--------------------------------

If you're not planning on regularly submitting changes, you can just
send your patch through to the mailing list and one of the regular
maintainers will see about incorporating it.


Useful Developer Information
============================

Some combined tips on developing with Cyrus have been collected.


Community Participation
=======================

Join us! The project is only as good as the sum of its people. We all
work together, despite the tyranny of distance and timezones.

Meetings are currently held online via Zoom.

There's also mailing lists.
