Release 2.0.0a3

Author: stevepiercy

Makefile

@@ -19,6 +19,7 @@ I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 #TODO: VALEFILES       := $(shell find $(DOCS_DIR) -type f -name "*.md" -print)
 #TODO: VALEOPTS        ?=
 PYTHONVERSION   = >=3.10,<3.15
+VERSION := $(shell uv version --short)
 
 # Add the following 'help' target to your Makefile
 # And add help text after each target name starting with '\#\#'
@@ -224,9 +225,14 @@ rtd-prepare:  ## Prepare environment on Read the Docs
 rtd-pr-preview: rtd-prepare dev ## Build pull request preview on Read the Docs
 	cd $(DOCS_DIR) && $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) ${READTHEDOCS_OUTPUT}/html/
 
-#TODO .PHONY: release
-#release: dev compile  ## Release with zest.releaser
-#	@uv run fullrelease
+.PHONY: dist
+dist:  ## Clean dist, then build the project
+	@git add .
+	@git commit -m "Release $(VERSION)"
+	@git tag $(VERSION)
+	@git push origin $(VERSION)
+	@rm -rf dist
+	@uv build
 
 .PHONY: all
 all: clean linkcheck html  ## Clean docs build, then run linkcheck, and build html

RELEASE.md

@@ -0,0 +1,43 @@
+# Release sphinxcontrib-httpdomain
+
+Use uv and make to release sphinxcontrib-httpdomain.
+
+Check the current version.
+
+```shell
+uv version
+```
+
+Find the correct command to bump the version from [uv's documentation](https://docs.astral.sh/uv/guides/package/#updating-your-version).
+Use `--dry-run` to check that the command will do what you expect.
+
+```shell
+uv bump --dry-run <args>
+```
+
+If it looks good, then drop the `--dry-run` flag, and run the command.
+
+```shell
+uv bump <args>
+```
+
+Commit the changes, tag the commit, push to the repository, clean the `dist` directory, build the project.
+
+```shell
+make dist
+```
+
+Publish the project.
+
+```shell
+uv publish
+```
+
+Create a git tag of the version, and push it.
+
+```shell
+git tag <version>
+git push origin <version>
+```
+
+Navigate to the [releases page](https://github.com/sphinx-contrib/httpdomain/releases) to publish the release.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sphinxcontrib-httpdomain"
-version = "2.0.0a1"
+version = "2.0.0a3"
 description = "Sphinx extension that provides a domain for documenting HTTP APIs."
 keywords = [
   "Sphinx",