diff --git a/docs/docsite/rst/network/getting_started/network_differences.rst b/docs/docsite/rst/network/getting_started/network_differences.rst
index 9fc4f11e9f7..832ba376494 100644
--- a/docs/docsite/rst/network/getting_started/network_differences.rst
+++ b/docs/docsite/rst/network/getting_started/network_differences.rst
@@ -30,7 +30,7 @@ Because network modules execute on the control node instead of on the managed no
    "netconf", "XML over SSH", "network_os setting"
    "local", "depends on provider", "provider setting"
 
-Beginning with Ansible 2.5, we recommend using ``network_cli`` or ``netconf`` for ``ansible_connection`` whenever possible. For details on using API over HTTPS connections, see the platform-specific pages.
+Beginning with Ansible 2.5, we recommend using ``network_cli`` or ``netconf`` for ``ansible_connection`` whenever possible. For details on using API over HTTPS connections, see the :ref:`platform-specific <platform_options>` pages.
 
 
 Modules Organized by Network Platform
@@ -43,7 +43,7 @@ A network platform is a set of network devices with a common operating system th
 - Juniper: ``junos_``
 - VyOS ``vyos_``
 
-All modules within a network platform share certain requirements. Some network platforms have specific differences - see the platform-specific documentation for details.
+All modules within a network platform share certain requirements. Some network platforms have specific differences - see the :ref:`platform-specific <platform_options>` documentation for details.
 
 
 Privilege Escalation: `authorize` and `become`
@@ -76,7 +76,7 @@ Some network platforms support privilege escalation but cannot use ``network_cli
      transport: eapi
      use_ssl: no
 
-And you use the ``setting`` variable in your play(s) or task(s):
+And you use the ``eapi`` variable in your play(s) or task(s):
 
 .. code-block:: yaml
 
diff --git a/docs/docsite/rst/network/user_guide/network_best_practices_2.5.rst b/docs/docsite/rst/network/user_guide/network_best_practices_2.5.rst
index 001d87db294..ebcdca3122b 100644
--- a/docs/docsite/rst/network/user_guide/network_best_practices_2.5.rst
+++ b/docs/docsite/rst/network/user_guide/network_best_practices_2.5.rst
@@ -22,10 +22,10 @@ Prerequisites
 
 This example requires the following:
 
-* **Ansible 2.5** (or higher) installed. See :doc:`../installation_guide/intro_installation` for more information.
+* **Ansible 2.5** (or higher) installed. See :doc:`../../installation_guide/intro_installation` for more information.
 * One or more network devices that are compatible with Ansible.
-* Basic understanding of YAML :doc:`../reference_appendices/YAMLSyntax`.
-* Basic understanding of Jinja2 Templates. See :doc:`../user_guide/playbooks_templating` for more information.
+* Basic understanding of YAML :doc:`../../reference_appendices/YAMLSyntax`.
+* Basic understanding of Jinja2 Templates. See :doc:`../../user_guide/playbooks_templating` for more information.
 * Basic Linux command line use.
 * Basic knowledge of network switch & router configurations.
 
@@ -118,7 +118,7 @@ Because Ansible is a flexible tool, there are a number of ways to specify connec
 
 .. warning:: Never store passwords in plain text.
 
-The "Vault" feature of Ansible allows you to keep sensitive data such as passwords or keys in encrypted files, rather than as plain text in your playbooks or roles. These vault files can then be distributed or placed in source control. See :doc:`../user_guide/playbooks_vault` for more information.
+The "Vault" feature of Ansible allows you to keep sensitive data such as passwords or keys in encrypted files, rather than as plain text in your playbooks or roles. These vault files can then be distributed or placed in source control. See :doc:`../../user_guide/playbooks_vault` for more information.
 
 :ansible_connection:
 
@@ -361,8 +361,8 @@ If you receive an connection error please double check the inventory and Playboo
 
 .. seealso::
 
-  * :doc:`../network/index`
-  * :doc:`../user_guide/intro_inventory`
+  * :ref:`network_guide`
+  * :doc:`../../user_guide/intro_inventory`
   * :ref:`Vault best practices <best_practices_for_variables_and_vaults>`