diff --git a/xml/Readme.md b/xml/Readme.md
index deefd3465e..126ae902d9 100644
--- a/xml/Readme.md
+++ b/xml/Readme.md
@@ -1,49 +1,58 @@
 # Updating schema files #
 
 ## Experimental features ##
 
 Experimental features go into `${base}-next.rng`
 
 Create from the most recent `${base}-${X}.${Y}.rng` if it does not already exist
 
 ## Stable features ##
 
 The current stable version is determined from the `known_schemas` array in `lib/common/xml.c`.
 It will be the entry prior to `pacemaker-next` and has the form `pacemaker-${X}.${Y}`.
 
 ### Simple Additions
 
 When the new syntax is a simple addition to the previous one, create a new entry with `${Y} = ${Yold} + 1` 
 
-### Feature Removal or Incompatible Changes
+### Feature Removal or otherwise Incompatible Changes
 
 When the new syntax is not a simple addition to the previous one, create a new entry with `${X} = ${Xold} + 1` and `${Y} = 0`.
 An XSLT file is also required that converts an old syntax to the new one.
 See `xml/upgrade06.xsl` for an example.
 
-
-Bump `${X}` and set `${Y}` to `0` for syntax removals, bump `${Y}` for additions and then,
-
 ### General Proceedure
 
-1. Add the new `${X}.${Y}` to `RNG_versions` in xml/Makefile.am,
-1. Copy the most recent version of `${base}-*.rng` to `${base}-${X}.${Y}.rng`
+1. Copy the most recent version of `${base}-*.rng` to `${base}-${X}.${Y}.rng` 
+1. Commit the copy, eg. `"Clone the latest ${base} schema in preparation for changes"`.  
+   This way the actual change will be included with the creation of the new schema.
+1. Modify `${base}-${X}.${Y}.rng` as required
+1. Add the new `${X}.${Y}` to `RNG_versions` in `xml/Makefile.am` 
+1. Add an XSLT file if required and update `xslt_SCRIPTS` in `xml/Makefile.am` 
 1. Update `known_schemas` in `lib/common/xml.c`, add it prior to the entry for `pacemaker-next`.
    The second last field of the previous entry needs to be set to `0`.
    For example:
             
         /* 6 */    { 2, "pacemaker-1.2",  NULL, NULL, -1, NULL },
         /* - */    { 2, "pacemaker-next", NULL, NULL, -1, NULL }, /* Feature playground */
             
    becomes:
             
         /* 6 */    { 2, "pacemaker-1.2",  NULL, NULL,  0, NULL },
         /* 7 */    { 2, "pacemaker-1.3",  NULL, NULL, -1, NULL },
         /* - */    { 2, "pacemaker-next", NULL, NULL, -1, NULL }, /* Feature playground */
-
+   
+   or for an incompatible change:
+   
+        /* 6 */    { 2, "pacemaker-1.2",  NULL, "upgrade12.xsl",  0, NULL },
+        /* 7 */    { 2, "pacemaker-2.0",  NULL, NULL, -1, NULL },
+        /* - */    { 2, "pacemaker-next", NULL, NULL, -1, NULL }, /* Feature playground */
+   
+   See https://github.com/beekhof/pacemaker/commit/041ba95 and its parent commit for an example.
+1. Commit
 
 ## Admin Tasks
 New features will not be available until the admin
 
 1. Updates all the nodes
-1. Runs the equivalent of cibadmin --upgrade
\ No newline at end of file
+1. Runs the equivalent of `cibadmin --upgrade`