README.md

@@ -3,8 +3,6 @@
 This is a little TUI based on [Textual] for entering new Teilchen and for
 searching for existing Teilchen. Data is kept in a sqlite database.
 
-It is not yet usable.
-
 ## Running tests
 
 ```sh
@@ -21,7 +19,7 @@ You will need two terminals:
   1. one for showing the console,
   2. the other to run the app.
 
-Since we use uv, the incantation is a bit different from the [official documenation].
+Since we use uv, the incantation is bit different from the official documenation:
 
 In one terminal:
 
@@ -38,10 +36,9 @@ uv run textual run --dev src/teilchensammler_cli/__init__.py
 
 ## Developing
 
-To re-create bronsen's development environment, sort of, you need several shiny
-new toys:
+To re-create bronsen's development environment, you need several shiny new toys:
 
-* [just] to run the recipes from `justfile`
+* [just] to run the recipes from `justfile` (think Makefile, but easier)
 * [uv] for all the python executing stuff, also venv
 * [prek] as a replacement for pre-commit
 * [ruff] to lint and format the python code
@@ -72,11 +69,11 @@ unwieldy.
 
 ## Bug Reports, Feature Requests
 
-Create them by clicking "Issues" at the top of the [repo page]. Do not worry
-too much about labels.
+Create them [under "Issues"] at the top the [repo page]. Do not worry too much
+about labels.
 
-Please be specific and provide logs, screenshots, or even a test that
-replicates the problem.
+Please be specific and provide logs, screenshots, a test that replicates the
+problem.
 
 ### Architectural Changes
 
@@ -90,31 +87,26 @@ I'll make an effort to update those to the best of my capabilities.
 
 ## AI
 
-Please don't: this is my little human-created thing.
+Please no: this is my little human-created thing.
 
 ## Creating a new release
 
 (This is so bronsen can forget.)
 
-* run tests; make sure they pass
+* make code changes
+* run tests; make them pass
 * commit
-* `uv version --bump {segment}`
+* `git tag vX.Y.Z`
+* push commits and tags
 
-  Where `segment` is one of: major, minor, patch, stable, alpha, beta, rc,
-  post, dev
-* commit
-* push commits
-* use lazygit to create the new version tag
-  * remember to prefix it with "v"
-* push the tags, using lazygit
+`uv build` will now create correctly named tar balls and wheels.
 
 ----
 
-[official documenation]: https://textual.textualize.io/guide/devtools/#console
 [Textual]: https://textual.textualize.io/
 [uv]: https://astral.sh/uv
 [just]: https://just.systems/
 [prek]: https://prek.j178.dev/
 [ruff]: https://astral.sh/ruff
 [markdownlint-cli2]: https://github.com/DavidAnson/markdownlint-cli2
-[repo page]: https://code.c-base.org/infuanfu/teilchensammler-cli
+[under "Issues"]: https://code.c-base.org/infuanfu/teilchensammler-cli/issues/new