[tor-commits] [sbws/master] Rephrase changelog documentation

juga at torproject.org juga at torproject.org
Tue Sep 25 09:48:10 UTC 2018


commit 997f5f4e366a75885b7f3f298a6e1de6b662a4a9
Author: juga0 <juga at riseup.net>
Date:   Fri Sep 14 20:01:14 2018 +0000

    Rephrase changelog documentation
---
 CONTRIBUTING.rst | 16 ++++------------
 1 file changed, 4 insertions(+), 12 deletions(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 65a2349..b61e220 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -93,6 +93,10 @@ Before release 1.0.0, some docstrigs do not have 3 double quotes ``"""``
 
 New features should add a corresponding documentation.
 
+Document your changes in ./CHANGELOG.rst following `keep a changelog`_.
+Reference the Tor Project Trac ticket (example: ``#12345``) or
+Github ticket (example: ``GH#123``).
+
 Timestamps must be in UTC. It is prefered to use ``datetime`` objects or
 Unix timestamps. Timestamps read by the user should be always formatted in
 `ISO 8601 <https://en.wikipedia.org/wiki/ISO_8601>`_
@@ -120,18 +124,6 @@ top of master or cherry-pick the changes.
 may get overwritten (for example: "transient\_" prefix). Instead of overwriting
 a branch, add a version suffix (for example: "_02").
 
-Coding Guidelines
-=================
-
-
-**Document your addition, fix, change, or whatever in the changelog**. See
-`keep a changelog`_ for the standard we follow. Of note, add Added, Changed,
-Deprecated, Removed, Fixed, and Security headings as needed in the Unreleased
-section. **If your change has a trac or GitHub ticket, reference it** like
-``(GH#123)`` or ``(trac#22104)``. When it comes time to do a release, the
-person doing the release should (1) change the name of the Unreleased section
-and add a new one, and (2) update the links at the bottom.
-
 
 .. _commit-msg:
 





More information about the tor-commits mailing list