Nowadays the contribution guide in every open-source project is not sufficient to describe the approaches, techniques, and how people solve break changes.

We all know: they are the most democratic projects we can work on, but sometimes not follow basic practices to elevate the project quality.

This talk will show you how to help the projects and the contributors to better understand the documentation, how they can contribute, and the process for it. You will learn about:

Changelog: how it’s important to maintain to tell others about the important changes made in the project, also maintaining it following the SemVer approach.

Breaking changes: it will show the breaking changes made in the project and how to solve them, hardly connected to both Changelog and SemVer.

Testing guide: approaches, ways of test creation, patterns, and tools in use will be placed on this guide to help the contributors to write better tests, extending the coverage and keeping the project’s quality level.