From 19e94815f9bc65bacca00e9c3c078d983a941b91 Mon Sep 17 00:00:00 2001 From: Travis Ralston Date: Thu, 17 Jan 2019 15:13:01 -0700 Subject: [PATCH] Try and improve the understanding of room versions --- specification/index.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/specification/index.rst b/specification/index.rst index cdd56cb2f..ea4026f0b 100644 --- a/specification/index.rst +++ b/specification/index.rst @@ -430,6 +430,13 @@ upon through new algorithms or rules, "room versions" are employed to manage a set of expectations for each room. New room versions are assigned as needed. +There is no implicit ordering or hierarchy to room versions, and their principles +are immutable once placed in the specification. Although there is a recommended +set of versions, some rooms may benefit from features introduced by other versions. +Rooms move between different versions by "upgrading" to the desired version. Due +to versions not being ordered or hierarchical, this means a room can "upgrade" to +version 1 from version 2, if it so desired. + Room version grammar ~~~~~~~~~~~~~~~~~~~~