summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--CONTRIBUTING.rst54
-rw-r--r--debian/changelog1
2 files changed, 55 insertions, 0 deletions
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 707e2f6..0db4ab0 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -1,3 +1,57 @@
+Submitting patches
+==================
+
+Thank you for your interest in contributing to this project!
+
+Please **do not** submit a pull request on GitHub. The repository
+there is an automated mirror, and I don't develop using GitHub's
+platform.
+
+Project mailing lists
+=====================
+
+There are two low-volume project mailing lists, shared with some other
+small free software projects:
+
+- sgo-software-announce --
+ <https://www.chiark.greenend.org.uk/mailman/listinfo/sgo-software-announce>
+
+ For release announcements.
+
+- sgo-software-discuss --
+ <https://www.chiark.greenend.org.uk/mailman/listinfo/sgo-software-discuss>
+
+ For bug reports, posting patches, user questions and discussion.
+
+Please prepend ``[mailscripts]`` to the subject line of your e-mail,
+and for patches, pass ``--subject-prefix="PATCH mailscripts"`` to
+git-send-email(1).
+
+Posting to sgo-software-discuss
+-------------------------------
+
+If you're not subscribed to the list, your posting will be held for
+moderation; please be patient.
+
+Whether or not you're subscribed, chiark.greenend.org.uk has
+aggressive antispam. If your messages aren't getting through, we can
+easily add a bypass on chiark; please contact <spwhitton@spwhitton.name>.
+
+If you don't want to deal with the mailing list and just want to send
+patches, you should feel free to pass ``--to=spwhitton@spwhitton.name``
+to git-send-email(1).
+
+Alternatively, publish a git branch somewhere publically accessible (a
+GitHub fork is fine) and write to me asking me to merge it. I may
+convert your branch back into patches when sending you feedback :)
+
+Reporting bugs
+==============
+
+Please read "How to Report Bugs Effectively" to ensure your bug report
+constitutes a useful contribution to the project:
+<https://www.chiark.greenend.org.uk/~sgtatham/bugs.html>
+
Signing off your commits
========================
diff --git a/debian/changelog b/debian/changelog
index 4e730d9..bee9aaf 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,6 +2,7 @@ mailscripts (0.20-1) UNRELEASED; urgency=medium
* imap-dl: Fix failure when python3-gssapi isn't installed (Closes: #955011).
Thanks to Robbie Harwood for the patch.
+ * Add mailing list info to CONTRIBUTING.md.
-- Sean Whitton <spwhitton@spwhitton.name> Fri, 27 Mar 2020 11:50:27 -0700