diff --git a/docs/docsite/rst/reference_appendices/faq.rst b/docs/docsite/rst/reference_appendices/faq.rst index 639bbc255e..4882c2df6b 100644 --- a/docs/docsite/rst/reference_appendices/faq.rst +++ b/docs/docsite/rst/reference_appendices/faq.rst @@ -401,14 +401,14 @@ For environment variables on the TARGET machines, they are available via facts i {{ ansible_env.SOME_VARIABLE }} -If you need to set environment variables for TASK execution, see the Advanced Playbooks section about environments. -There is no set way to set environment variables on your target machines, you can use template/replace/other modules to do so, -but the exact files to edit vary depending on your OS and distribution and local configuration. +If you need to set environment variables for TASK execution, see :ref:`playbooks_environment` in the :ref:`Advanced Playbooks ` section. +There are several ways to set environment variables on your target machines. You can use the :ref:`template `, :ref:`replace `, or :ref:`lineinfile ` modules to introduce environment variables into files. +The exact files to edit vary depending on your OS and distribution and local configuration. .. _user_passwords: -How do I generate crypted passwords for the user module? -++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +How do I generate encrypted passwords for the user module? +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Ansible ad-hoc command is the easiest option: diff --git a/docs/docsite/rst/user_guide/playbooks_special_topics.rst b/docs/docsite/rst/user_guide/playbooks_special_topics.rst index bfb7a8ca3f..95761f51a5 100644 --- a/docs/docsite/rst/user_guide/playbooks_special_topics.rst +++ b/docs/docsite/rst/user_guide/playbooks_special_topics.rst @@ -1,8 +1,10 @@ +.. _playbooks_special_topics: + Advanced Playbooks Features =========================== -Here are some playbook features that not everyone may need to learn, but can be quite useful for particular applications. -Browsing these topics is recommended as you may find some useful tips here, but feel free to learn the basics of Ansible first +Here are some playbook features that not everyone may need to learn, but can be quite useful for particular applications. +Browsing these topics is recommended as you may find some useful tips here, but feel free to learn the basics of Ansible first and adopt these only if they seem relevant or useful to your environment. .. toctree::