Draft: Replace static Michelson reference with interactive reference
Owned by @baugr.
This is a follow-up on !1264 (closed)
An important goal of the interactive Michelson reference is to replace the static Michelson reference in the documentation or more specifically, the section on core data types and instructions (as several sections of the static reference: annotations, macros, etc are not covered by this reference). Otherwise, the two references will diverge.
This MR removes those sections from the static reference and replaces them with pointers the interactive reference.
See also the MR in the interactive reference where I'm adding information present in the static reference but not in the interactive.
Todo
-
Host sources under tezos org repo -
Host generated documentation under tezos.gitlab.io -
Make sure the static/interactive documentations are aligned -
Clarify what of the static documentation is not covered by the interactive documentation. Examples currently of things not covered: macros, annotations, noop operations CAST and RENAME. -
Clear instructions for how to update the documentation (adding/remove/modifying instructions). -
More longterm: move all of static (macros, annotations, ...) into the interactive one.
Edited by Sventimir