RelicRELIC
Topic

Shipping better code

Good repos run on a few small conventions: commit messages a tool can parse, version numbers that mean something, and templates that make the next contribution easier than the last. This series covers each one, with copyable examples.

Start here
Pillar·9 min

Conventional Commits, explained accurately

A small, strict format for commit messages that both people and tools can read. The spec accurately, why feat means MINOR and fix means PATCH, and how to adopt it without the process turning sour.

Read
In this topic
9 min

Semantic versioning (SemVer), explained

The MAJOR.MINOR.PATCH scheme behind almost every package you install. What bumps what, the odd 0.x rules, version ranges in npm and pip, and the one promise SemVer quietly cannot keep.

Read
8 min

A pull request template you can copy today

A Markdown file your host pre-fills into every new PR. Three templates to copy, where the file lives on GitHub and GitLab, and what separates a checklist people use from one they delete.

Read
7 min

A README template that people actually read

The front door of a project, and most visitors decide within the first screen. A copyable README skeleton that leads with the quick start, plus the reasoning and a minimal variant.

Read