diff --git a/docs/008/voting.rst b/docs/008/voting.rst index 86a2f5cc1cd592b6e15526d386c58d5f5c1b4b35..4ea62f48a4d69bf8ccf85f6cc9b4a299efa252be 100644 --- a/docs/008/voting.rst +++ b/docs/008/voting.rst @@ -1,3 +1,6 @@ +.. _voting: +.. _voting_008: + The Voting Process ================== diff --git a/docs/009/voting.rst b/docs/009/voting.rst index a66f180b3729f6ba8dc0dd893db0e4e8b8fe6a25..52966ab7110ecd7239838626b57dc8b58a1d3c77 100644 --- a/docs/009/voting.rst +++ b/docs/009/voting.rst @@ -1,3 +1,5 @@ +.. _voting_009: + The Voting Process ================== diff --git a/docs/README.rst b/docs/README.rst index 9a7b5fad26351a76b55b07c99d0cf14000459997..fde410deca89298a5ac14c9abd1580c8d85e74cc 100644 --- a/docs/README.rst +++ b/docs/README.rst @@ -98,7 +98,7 @@ However, when adding a new page or modifying an existing one, you should check t For that, you should build the documentation (by running ``make`` in the ``docs`` directory), address any new error message, and check the generated pages (`docs/_build/index.html`) in a browser. Links -~~~~ +~~~~~ +When introducing cross-references between documentation pages as well as references to external resources, please consider using the most appropriate kind of link: diff --git a/docs/alpha/voting.rst b/docs/alpha/voting.rst index ce14b4cde181f909bfb7427cc4e8ab6e446c259e..84ce3bb325e3838b7e4ff61539ce98ea1f32aae8 100644 --- a/docs/alpha/voting.rst +++ b/docs/alpha/voting.rst @@ -1,3 +1,5 @@ +.. _voting_alpha: + The Voting Process ================== diff --git a/docs/developer/profiling.rst b/docs/developer/profiling.rst index 612b9e67bcd5c21cb8f17bb75a4096e64c4ca56c..612377f2de12f7c4be01bb276fbe358f5e83e418 100644 --- a/docs/developer/profiling.rst +++ b/docs/developer/profiling.rst @@ -91,8 +91,8 @@ Performance profiling - `flamegraph `_: command-line tool for generating flamegraphs - (`example `_ for tezos-node) + (`example `__ for tezos-node) - `gprof2dot `_: command-line tool for generating callgraphs - (`example `_ for tezos-node) + (`example `__ for tezos-node) - `hotspot `_: a GUI for the `perf` tool diff --git a/docs/introduction/howtouse.rst b/docs/introduction/howtouse.rst index 3a92b668566ebaded5c619c681b0d0c1a296063d..d85a4377b290e55258e289d5b7cc8d49d4162ee2 100644 --- a/docs/introduction/howtouse.rst +++ b/docs/introduction/howtouse.rst @@ -160,7 +160,7 @@ means that your node will take some time to resync the chain. If removing this directory, please note that if it took you a long time to compute your node identity, keep the ``identity.json`` file and instead only -remove its child ``store``, ``context`` and ``protocol``(if any) sub-directories. +remove its child ``store``, ``context`` and ``protocol`` (if any) sub-directories. If you are also running a baker, make sure that it is configured to access the data directory of the node (see :ref:`how to run a baker `). diff --git a/docs/protocols/alpha.rst b/docs/protocols/alpha.rst index abe98092013ad0beb4a5722b86641bc4bd4fafdb..bec15095bbee5be1efe42338bc9ab4c30ad7ddcb 100644 --- a/docs/protocols/alpha.rst +++ b/docs/protocols/alpha.rst @@ -49,7 +49,7 @@ The values of the ``BLOCKS_PER_*`` constants has doubled in order to match the reduced block times, as follows: ``BLOCKS_PER_CYCLE = 8192``, ``BLOCKS_PER_COMMITMENT = 64``, ``BLOCKS_PER_ROLL_SNAPSHOT = 512``, and ``BLOCKS_PER_VOTING_PERIOD = 40960``. This partially solves issue: `tezos#1027 `__ - `tezos!2531 `__ +via MR `tezos!2531 `__ . Liquidity Baking ---------------- @@ -72,16 +72,16 @@ RPC changes - Remove deprecated RPCs and deprecated fields in RPC answers related to voting periods. (MR `tezos!2763 `__, addresses - issue `tezos#1204 __.) + issue `tezos#1204 `__.) - The RPC ``..//required_endorsements`` has been removed. - Replace `deposit` by `deposits` in `frozen_balance` RPC. - All the protocol-specific RPCs under the ``helpers`` path have been -moved from the protocol to the `recently introduced `_ RPC -plugin. This change should not be visible for end-users but improves -the maintainability of these RPCs. + moved from the protocol to the `recently introduced `_ RPC + plugin. This change should not be visible for end-users but improves + the maintainability of these RPCs. Minor changes ------------- diff --git a/docs/user/multisig.rst b/docs/user/multisig.rst index a0a2f95c52b2dc829d7893b5143b8fd30dcc5052..8d30fe196d1c1945902f9a006aa3a671b54c013a 100644 --- a/docs/user/multisig.rst +++ b/docs/user/multisig.rst @@ -17,7 +17,7 @@ multisig contract has built-in support in the ``tezos-client`` and has been formally verified using the `Mi-Cho-Coq `_ framework. Interacting with a multisig contract using ``tezos-client`` -------------------------------------------------------- +----------------------------------------------------------- The recommended way to create and use a multisig contract is via the ``tezos-client`` built-in commands for the multisig contract. The command