summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorAlicia Cozine <879121+acozine@users.noreply.github.com>2019-11-01 15:32:07 -0500
committerGitHub <noreply@github.com>2019-11-01 15:32:07 -0500
commitc486638e4e5d300189138cbc041de148aeaf62ff (patch)
treed75b04ce1f8baafa0df4cfd5e178a9adfd8c456f /docs
parent0c6cb417e58c4aac01ae7709ae468893ec574b1a (diff)
downloadansible-c486638e4e5d300189138cbc041de148aeaf62ff.tar.gz
add general facts-to-info paragraph (#64293) (#64297)
(cherry picked from commit 6e07d4c1d932823331eba895d835b54105e394d6)
Diffstat (limited to 'docs')
-rw-r--r--docs/docsite/rst/porting_guides/porting_guide_2.9.rst5
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/docsite/rst/porting_guides/porting_guide_2.9.rst b/docs/docsite/rst/porting_guides/porting_guide_2.9.rst
index 008fa46677..1bad119fec 100644
--- a/docs/docsite/rst/porting_guides/porting_guide_2.9.rst
+++ b/docs/docsite/rst/porting_guides/porting_guide_2.9.rst
@@ -63,6 +63,11 @@ Modules
* The ``win_get_url`` and ``win_uri`` module now sends requests with a default ``User-Agent`` of ``ansible-httpget``. This can be changed by using the ``http_agent`` key.
* The ``apt`` module now honors ``update_cache=false`` while installing its own dependency and skips the cache update. Explicitly setting ``update_cache=true`` or omitting the param ``update_cache`` will result in a cache update while installing its own dependency.
+Renaming from ``_facts`` to ``_info``
+--------------------------------------
+
+Ansible 2.9 renamed a lot of modules from ``<something>_facts`` to ``<something>_info``, because the modules do not return :ref:`Ansible facts <vars_and_facts>`. Ansible facts relate to a specific host. For example, the configuration of a network interface, the operating system on a unix server, and the list of packages installed on a Windows box are all Ansible facts. The renamed modules return values that are not unique to the host. For example, account information or region data for a cloud provider. Renaming these modules should provide more clarity about the types of return values each set of modules offers.
+
Writing modules
---------------