Contributing

If you have reached this page you have taken the first step as a contributor and we thank you for your interest in our Open Source project.

Before going any further here are some key aspects of how we operate and the principles we apply.

 

We are Agile – as project maintainers we work in Kanban a lean method to manage and improve work across human systems. This approach helps to manage work by balancing the demands with available capacity, and improving the handling of bottlenecks.

 

We follow a streamlined development process from plan through to deploy that enables a continuous integrated flow and continuous feedback to continually enhance and improve.

Continuous Integration and Continuous delivery

 

We apply the use of semantic versioning that uses a three-part number, MAJOR.MINOR.PATCH. Each of the parts is incremented as follows:

  • MAJOR, when a change is API-incompatible with previous releases
  • MINOR, when new functionality is added in a backwards-compatible manner
  • PATCH, when bug fixes are made in a backward-compatible manner

Semantic versioning provides a shared indication for library authors and users to communicate with each other.

 

All pull requests undergo peer review to ensure a consistent and high quality code base, combined with automated testing this ensures no breaking changes make it out in each release.

 

Our release train is on a monthly cycle where possible, with new versions of components, new features, patches, or bug fixes tested and shipped for deployment. Release notes are provided with each release to ensure the recipient knows what they are getting and what they are installing.

There are 3 distinct .Stat Suite delivery mechanisms being put in place:

  1. .Stat Suite as a service: no technical skills required, limited configuration possible, and subscription costs for cloud service provisioning and maintenance required.
  2. .Stat Suite as containers: requires knowledge of docker (open source container technology) and orchestration, as well as deployment, maintenance or continuity of service is the receiving organisation’s responsibility.
  3. .Stat Suite as a codebase: requires a technical knowledge of the underlying ecosystems (.Net, JavaScript, SQL etc.), with Continuous Integration being the receiving organisation’s responsibility.

 

What next?

If you like what you read and would like to get involved, then please first read our code of conduct, then contact us and we will let you know the next steps to becoming an active contributor to our Open Source project.