@@ 1,20 1,34 @@
# Violet Moon
-This is a SourceHut project that mirrors certain projects from https://github.com/VazkiiMods to SourceHut.
+## About
+Violet Moon is a team that produces Minecraft mods. Read more on our [website](https://violetmoon.org/).
-Certain members of the development team prefer the mailing list and patch workflow to the GitHub PR model,
-so this project is to accomodate them.
+## SourceHut Mirror
+This is a SourceHut project that mirrors certain projects from the official upstream
+https://github.com/VazkiiMods to SourceHut.
+
+Certain members of the development team prefer the mailing list and patch workflow to the
+GitHub PR model, so this project is to accomodate them.
## Repositories
The repos mirrored can be seen in the tab above. Note that GitHub remains the upstream and
these repos will not be pushed to directly.
-They are mirrored to allow CI to be run on builds.sr.ht
+They are mirrored to allow CI to be run on builds.sr.ht.
## Mailing Lists
-Email patches to `~williewillus/violet-moon@lists.sr.ht`. Be sure to prefix
-the subject line with the repository the patch targets, e.g. `[PATCH botania]`.
-
+### Announcements
+High-signal announcements, usually of mod releases and updates, will be posted to
+the [~williewillus/violet-moon-announce](https://lists.sr.ht/~williewillus/violet-moon-announce)
+mailing list.
+
+### Contributing Patches
+Discuss development and email patches to `~williewillus/violet-moon@lists.sr.ht`.
+Note that only some Violet Moon projects use the email workflow, at the time of writing
+Botania and Patchouli are prioritized.
+
+Be sure to prefix the subject line with the repository the patch targets,
+e.g. `[PATCH botania]`.
You can configure this by running `git config format.subjectPrefix botania`
in your local checkout (replacing `botania` with the appropriate repository name).