[tor-commits] [tor/master] doc: Update our requirements for changes file

[nickm at torproject.org]

commit ca1003b79178b8a01dc5fe3a14550e521a4035b0
Author: David Goulet <dgoulet at torproject.org>
Date:   Thu Jul 16 13:34:52 2020 -0400

    doc: Update our requirements for changes file
    
    Closes tpo/core/team#3.
    
    Signed-off-by: David Goulet <dgoulet at torproject.org>
---
 doc/HACKING/CodingStandards.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/HACKING/CodingStandards.md b/doc/HACKING/CodingStandards.md
index e9bb75b986..45e33a6777 100644
--- a/doc/HACKING/CodingStandards.md
+++ b/doc/HACKING/CodingStandards.md
@@ -87,6 +87,18 @@ months and expect it to merge cleanly. Try to merge pieces early and often.
 
 ## How we log changes
 
+Before diving in the details on how to write a changes file, note that we do
+NOT require a changes file for:
+
+  * Any change to a file that is not distributed in the tarball. This
+    includes:
+    - Any change to our CI configuration that does not affect the distributed
+      source.
+    - Any change to developer-only tools, unless those tools are distributed
+      in the tarball.
+  * Non-functional code movement.
+  * Identifier re-namings, comment edits, spelling fixes, and so on.
+
 When you do a commit that needs a ChangeLog entry, add a new file to
 the `changes` toplevel subdirectory.  It should have the format of a
 one-entry changelog section from the current ChangeLog file, as in