From 2c9707633ef8f31ff2fc5e129cf808537cf10bd5 Mon Sep 17 00:00:00 2001 From: Matthew Hodgson Date: Tue, 11 Nov 2014 21:11:01 +0200 Subject: [PATCH] tone down warning --- specification/00_basis.rst | 25 ++++++++++--------------- 1 file changed, 10 insertions(+), 15 deletions(-) diff --git a/specification/00_basis.rst b/specification/00_basis.rst index 9e7ae8ed..6c00d764 100644 --- a/specification/00_basis.rst +++ b/specification/00_basis.rst @@ -1,21 +1,6 @@ Matrix Specification ==================== -WARNING -======= - -.. WARNING:: - The Matrix specification is still very much evolving: the API is not yet frozen - and this document is in places incomplete, stale, and may contain security - issues. Needless to say, we have made every effort to highlight the problem - areas that we're aware of. - - We're publishing it at this point because it's complete enough to be more than - useful and provide a canonical reference to how Matrix is evolving. Our end - goal is to mirror WHATWG's `Living Standard `_ - approach except right now Matrix is more in the process of being born than actually being - living! - Table of Contents ================= @@ -28,6 +13,16 @@ communication ecosystem on the internet. This specification is the ongoing result of standardising the APIs used by the various components of the Matrix ecosystem to communicate with one another. +.. WARNING:: + The Matrix specification is still evolving: the APIs are not yet frozen + and this document is in places a work in progress or stale. We have made every + effort to clearly flag areas which are still being finalised. + + We're publishing it at this point because it's complete enough to be more than + useful and provide a canonical reference to how Matrix is evolving. Our end + goal is to mirror WHATWG's `Living Standard + `_. + The principles that Matrix attempts to follow are: - Pragmatic Web-friendly APIs (i.e. JSON over REST)