Don't compile doccomments - they are illustrative

primitives/src/runtime_api.rs

@@ -22,17 +22,17 @@
 //!
 //! All stable API functions should use primitives from the latest version.
 //! In the time of writing of this document - this is v2. So for example:
-//! ```rust
+//! ```ignore
 //! fn validators() -> Vec<v2::ValidatorId>;
 //! ```
 //! indicates a function from the stable v2 API.
 //!
 //! On the other hand a staging function might look like this:
-//! ```rust
+//! ```ignore
 //! fn get_session_disputes() -> Vec<(vstaging::SessionIndex, vstaging::CandidateHash, vstaging::DisputeState<vstaging::BlockNumber>)>;
 //! ```
 //! or this:
-//! ```rust
+//! ```ignore
 //! fn unstable_get_session_disputes() -> Vec<(vstaging::SessionIndex, vstaging::CandidateHash, vstaging::DisputeState<vstaging::BlockNumber>)>;
 //! ```
 //! In the second example the function is prefixed with `unstable_`. This
@@ -43,7 +43,7 @@
 //!
 //! Once a staging function is ready to be versioned the `changed_in` macro
 //! can be used to rename it and version it. For the example above:
-//! ```rust
+//! ```ignore
 //! fn get_session_disputes() -> Vec<(v3::SessionIndex, v3::CandidateHash, v3::DisputeState<v3::BlockNumber>)>;
 //!
 //! #[changed_in(2)]