Add more detail about reserving tokens to the README.
authorJohn Kessenich <cepheus@frii.com>
Sat, 8 Jun 2019 05:05:30 +0000 (23:05 -0600)
committerJohn Kessenich <cepheus@frii.com>
Sat, 8 Jun 2019 05:05:30 +0000 (23:05 -0600)
README.md

index 846b20d..beb1b7e 100644 (file)
--- a/README.md
+++ b/README.md
@@ -25,10 +25,18 @@ the files under [include](include).
 
 The SPIR-V XML registry file is updated by Khronos whenever a new enum range is allocated.
 
-Pull requests can be made to 
+Pull requests can be made to
 - request allocation of new enum ranges in the XML registry file
 - reserve specific tokens in the JSON grammar
 
+### Reserving tokens in the JSON grammar
+
+Care should be taken to follow existing precedent in populating the details of reserved tokens. This includes:
+- pointing to what extension has more information, when possible
+- keeping enumerants in numeric order
+- when there are aliases, listing the preferred spelling first
+- adding the statement `"version" : "None"`
+
 ## How to install the headers
 
 ```