Back to Navi

Navi contributors

docs/contributions/README.md

2.24.01.8 KB
Original Source

Navi contributors

This section is about the ways you can contribute to Navi and its ecosystem.

<!-- TOC --> <!-- TOC -->

How to contribute to Navi

You have multiple ways to contribute to navi, here are the documented ones:

Please see each section for more details.

Versioning Scheme

TypeDescription
MajorAnything which introduces a major breaking change. The bash to rust rewrite was such an example.
MinorAlmost everything.
FixA fix, just like its name. It should be micro releases with minimal changes.

Deprecation of features

Once you introduce a feature, you need to have a clear view of when we're going to remove its support within navi.

In order to offer stability to the users, we prefer having 10 minor versions between the deprecation notice and the removal of its support.

txt
Version where the feature is being deprecated: 0.10.0
Version where the support is dropped: 0.20.0

[!NOTE] This rule is not absolute and each feature deprecation needs to be handled carefully given its own circumstances, but try to stick as close as possible to this rule.