Docs: add final note explaining the current state of the document
Link to other issues with more accurate discussions and up-to-date information.
@@ -11,6 +11,28 @@ proposing a clear direction to move forward with intermediate steps keeping back
.. _Explicit Builders: https://github.com/readthedocs/readthedocs.org/pull/8103/
+.. note::
+
+ A lot of things have changed since this document was written.
+ We have had multiple discussions where we already took some decisions and discarded some of the ideas/details proposed here.
+ The document was merged as-is without a cleaned up and there could be some inconsistencies.
+ Note that ``build.jobs`` and ``build.commands`` are already implemented *without definig a contract* yet,
+ and with small differences from the idea described here.
+
+ Please, refer to the following links to read more about all the discussions we already had:
+
+ - Public discussions:
+ - https://github.com/readthedocs/readthedocs.org/issues/9062
+ - https://github.com/readthedocs/readthedocs.org/issues/1083
+ - https://github.com/readthedocs/readthedocs.org/issues/9063
+ - https://github.com/readthedocs/readthedocs.org/issues/9088
+
+ - Private discussions:
+ - https://github.com/readthedocs/meta/discussions/9
+ - https://github.com/readthedocs/meta/discussions/14
+ - https://github.com/readthedocs/meta/discussions/17
+
+
Goals
-----
