From e7b0f6d45ebed75f31ea1a3fbffb3e8667a48281 Mon Sep 17 00:00:00 2001
From: Keith Bourgoin <keith.bourgoin@gmail.com>
Date: Mon, 5 Aug 2024 21:02:25 -0400
Subject: [PATCH] Fix formatting to be reST.

---
 doc/releases.rst | 40 +++++++++++++++++++++++++++++++---------
 1 file changed, 31 insertions(+), 9 deletions(-)

diff --git a/doc/releases.rst b/doc/releases.rst
index 0142527..c1cac7e 100644
--- a/doc/releases.rst
+++ b/doc/releases.rst
@@ -1,10 +1,32 @@
-# Cutting a new release
-
-1. Update the version number in `version.py` using semver versioning rules.
-2. Tag your commit with the new version number. ie `git tag -a v0.1.0.dev0 -m "v0.1.0.dev0"` or `git tag -a v0.1.0 -m "v0.1.0" <commit hash>`
-3. Push the tag to GitHub. `git push origin v0.1.0`
-4. Install twine and install build. `pip install twine` and `pip install build`
-5. Build the package. `python -m build`
-6. Upload the package to test.pypi.org. `twine upload --repository testpypi dist/*` and verify you can install the test package.
-7. Upload the package to pypi.org. `twine upload dist/*` and verify you can install the package.
+Creating a new Streamparse Release
+==================================
+
+1. Update the version number in ``version.py`` using `semantic versioning <https://semver.org>`.
+2. Tag your commit with the new version number. For example:::
+
+   git tag -a v0.1.0 -m "v0.1.0"
+
+3. Push the tag to GitHub::
+
+   git push origin v0.1.0
+
+4. Install twine and install build.
+
+   pip install twine
+   pip install build
+
+5. Build the package.
+
+   python -m build
+
+6. Upload the package to test.pypi.org and verify you can install it::
+
+   twine upload --repository testpypi dist/*
+
+7. Upload the package to pypi.org and verify you can install it::
+
+   twine upload dist/*
+
 8. Create a new release on GitHub.
+
+.. _SEMVER: https://semver.org