diff options
authorJonas Wielicki <j.wielicki@sotecware.net>2017-09-24 11:09:47 +0200
committerJonas Wielicki <j.wielicki@sotecware.net>2017-09-24 11:12:38 +0200
commit20852ecf2da9f164c5500b9cea04d2c7619693b0 (patch)
parentb75992b648ed87556d5536fc8df21b1aff955869 (diff)
Add note on deferrals utility to README
1 files changed, 33 insertions, 0 deletions
diff --git a/README.md b/README.md
index bed8f5d..2a8617b 100644
--- a/README.md
+++ b/README.md
@@ -385,6 +385,39 @@ whether or not they are required.
For a helpful graph of how XEP promotion works, see [XEP-0001].
+Deferring XEPs
+Before Deferring XEPs, read the "General notes on making changes" section.
+XEPs get deferred after 12 months of inactivity. There is a tool which handles
+that process automatically, if it is invoked regularly.
+First of all, you need an up-to-date ``xeplist.xml``:
+ make build/xeplist.xml
+To get a list of XEPs which need to be deferred (without changing anything),
+ ./tools/deferrals.py -v
+To apply the deferrals, make a new feature branch and execute:
+ ./tools/deferrals.py -m 'initials'
+where you replace ``initials`` with your editor initials so that it is obvious
+who made the change (those initials will be used in the revision block).
+This will modify the XEPs in-place. It uses heuristics for incrementing the
+version number, finding and inserting the revision block as well as changing
+the status. Yes, it involves regular expressions (because we don’t want to
+fully re-write the XML to keep the diffs minimal). It is thus vital that you
+**use `git diff` to ensure that the changes are sane**. If the changes
+are sane, make a commit and merge to master as described in "Merging a PR",
+in accordance with the "General notes on making changes".
Merging a PR