From ab05ac25d2dc433b3027d3b5bc59686c15e8d9d0 Mon Sep 17 00:00:00 2001 From: Sandra McCann Date: Thu, 5 Aug 2021 12:55:22 -0400 Subject: [PATCH] Issue 73792: Removed mentions of R() and M() (#74708) (#75300) * 73792: Removed mentions of R and M (cherry picked from commit bf9944266c45ed3e9001520e1894bf9a212f49de) Co-authored-by: Lydie <44351234+lmalivert@users.noreply.github.com> --- .../rst/dev_guide/developing_modules_documenting.rst | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/docs/docsite/rst/dev_guide/developing_modules_documenting.rst b/docs/docsite/rst/dev_guide/developing_modules_documenting.rst index 67a4bdd91e6..49e2d7b5524 100644 --- a/docs/docsite/rst/dev_guide/developing_modules_documenting.rst +++ b/docs/docsite/rst/dev_guide/developing_modules_documenting.rst @@ -235,8 +235,6 @@ You can link from your module documentation to other module docs, other resource * ``L()`` for links with a heading. For example: ``See L(Ansible Automation Platform,https://www.ansible.com/products/automation-platform).`` As of Ansible 2.10, do not use ``L()`` for relative links between Ansible documentation and collection documentation. * ``U()`` for URLs. For example: ``See U(https://www.ansible.com/products/automation-platform) for an overview.`` -* ``R()`` for cross-references with a heading (added in Ansible 2.10). For example: ``See R(Cisco IOS Platform Guide,ios_platform_options)``. Use the RST anchor for the cross-reference. See :ref:`adding_anchors_rst` for details. -* ``M()`` for module names. For example: ``See also M(ansible.builtin.yum) or M(community.general.apt_rpm)``. There are also some macros which do not create links but we use them to display certain types of content in a uniform way: @@ -249,16 +247,13 @@ content in a uniform way: .. note:: - For links between modules and documentation within a collection, you can use any of the options above. For links outside of your collection, use ``R()`` if available. Otherwise, use ``U()`` or ``L()`` with full URLs (not relative links). For modules, use ``M()`` with the FQCN or ``ansible.builtin`` as shown in the example. If you are creating your own documentation site, you will need to use the `intersphinx extension `_ to convert ``R()`` and ``M()`` to the correct links. - + For links between modules and documentation within a collection, you can use either of the options above. Use ``U()`` or ``L()`` with full URLs (not relative links). .. note:: - - To refer to a group of modules in a collection, use ``R()``. When a collection is not the right granularity, use ``C(..)``: + - When a collection is not the right granularity, use ``C(..)``: - - ``Refer to the R(kubernetes.core collection, plugins_in_kubernetes.core) for information on managing kubernetes clusters.`` - ``The C(win_*) modules (spread across several collections) allow you to manage various aspects of windows hosts.`` - .. note:: Because it stands out better, use ``seealso`` for general references over the use of notes or adding links to the description.