Fix typos, improve markup, improve scenario guide (#699)

* Fix typos.

* Improve markup.

* Mention missing 'new' modules in scenario guide.

CHANGELOG.rst

@@ -336,7 +336,7 @@ Minor Changes
 - docker_container - allow to specify ``platform`` (https://github.com/ansible-collections/community.docker/issues/123, https://github.com/ansible-collections/community.docker/pull/426).
 - modules and plugins communicating directly with the Docker daemon - improve default TLS version selection for Python 3.6 and newer. This is only a change relative to older community.docker 3.0.0 pre-releases or with respect to Docker SDK for Python < 6.0.0. Docker SDK for Python 6.0.0 will also include this change (https://github.com/ansible-collections/community.docker/pull/434).
 - modules and plugins communicating directly with the Docker daemon - simplify use of helper function that was removed in Docker SDK for Python to find executables (https://github.com/ansible-collections/community.docker/pull/438).
-- socker_handler and socket_helper module utils - improve Python forward compatibilty, create helper functions for file blocking/unblocking (https://github.com/ansible-collections/community.docker/pull/415).
+- socker_handler and socket_helper module utils - improve Python forward compatibility, create helper functions for file blocking/unblocking (https://github.com/ansible-collections/community.docker/pull/415).
 
 Breaking Changes / Porting Guide
 --------------------------------
@@ -529,7 +529,7 @@ Minor Changes
 Bugfixes
 --------
 
-- docker_container, docker_image - adjust image finding code to pecularities of ``podman-docker``'s API emulation when Docker short names like ``redis`` are used (https://github.com/ansible-collections/community.docker/issues/292).
+- docker_container, docker_image - adjust image finding code to peculiarities of ``podman-docker``'s API emulation when Docker short names like ``redis`` are used (https://github.com/ansible-collections/community.docker/issues/292).
 
 v2.1.1
 ======
@@ -578,7 +578,7 @@ Bugfixes
 
 - docker_api connection plugin - avoid passing an unnecessary argument to a Docker SDK for Python call that is only supported by version 3.0.0 or later (https://github.com/ansible-collections/community.docker/pull/243).
 - docker_container_exec - ``chdir`` is only supported since Docker SDK for Python 3.0.0. Make sure that this option can only use when 3.0.0 or later is installed, and prevent passing this parameter on when ``chdir`` is not provided to this module (https://github.com/ansible-collections/community.docker/pull/243, https://github.com/ansible-collections/community.docker/issues/242).
-- nsenter connection plugin - ensure the ``nsenter_pid`` option is retrieved in ``_connect`` instead of ``__init__`` to prevent a crasher due to bad initialization order (https://github.com/ansible-collections/community.docker/pull/249).
+- nsenter connection plugin - ensure the ``nsenter_pid`` option is retrieved in ``_connect`` instead of ``__init__`` to prevent a crash due to bad initialization order (https://github.com/ansible-collections/community.docker/pull/249).
 - nsenter connection plugin - replace the use of ``--all-namespaces`` with specific namespaces to support compatibility with Busybox nsenter (used on, for example, Alpine containers) (https://github.com/ansible-collections/community.docker/pull/249).
 
 v2.0.1
@@ -828,9 +828,9 @@ Bugfixes
 
 - docker_container - fix healthcheck disabling idempotency issue with strict comparison (https://github.com/ansible-collections/community.docker/issues/85).
 - docker_image - prevent module failure when removing image that is removed between inspection and removal (https://github.com/ansible-collections/community.docker/pull/87).
-- docker_image - prevent module failure when removing non-existant image by ID (https://github.com/ansible-collections/community.docker/pull/87).
+- docker_image - prevent module failure when removing non-existent image by ID (https://github.com/ansible-collections/community.docker/pull/87).
 - docker_image_info - prevent module failure when image vanishes between listing and inspection (https://github.com/ansible-collections/community.docker/pull/87).
-- docker_image_info - prevent module failure when querying non-existant image by ID (https://github.com/ansible-collections/community.docker/pull/87).
+- docker_image_info - prevent module failure when querying non-existent image by ID (https://github.com/ansible-collections/community.docker/pull/87).
 
 New Modules
 -----------
@@ -985,7 +985,7 @@ Removed Features (previously deprecated)
 - docker_image - the ``source`` option is now mandatory (https://github.com/ansible-collections/community.docker/pull/1).
 - docker_image - the ``use_tls`` option has been removed. Use ``tls`` and ``validate_certs`` instead (https://github.com/ansible-collections/community.docker/pull/1).
 - docker_image - the default of the ``build.pull`` option changed to ``false`` (https://github.com/ansible-collections/community.docker/pull/1).
-- docker_image_facts - this alias is on longer availabe, use ``docker_image_info`` instead (https://github.com/ansible-collections/community.docker/pull/1).
+- docker_image_facts - this alias is on longer available, use ``docker_image_info`` instead (https://github.com/ansible-collections/community.docker/pull/1).
 - docker_network - no longer returns ``ansible_facts`` (https://github.com/ansible-collections/community.docker/pull/1).
 - docker_network - the ``ipam_options`` option has been removed. Use ``ipam_config`` instead (https://github.com/ansible-collections/community.docker/pull/1).
 - docker_service - no longer returns ``ansible_facts`` (https://github.com/ansible-collections/community.docker/pull/1).

changelogs/changelog.yaml

@@ -36,7 +36,7 @@ releases:
         instead (https://github.com/ansible-collections/community.docker/pull/1).
       - docker_image - the default of the ``build.pull`` option changed to ``false``
         (https://github.com/ansible-collections/community.docker/pull/1).
-      - docker_image_facts - this alias is on longer availabe, use ``docker_image_info``
+      - docker_image_facts - this alias is on longer available, use ``docker_image_info``
         instead (https://github.com/ansible-collections/community.docker/pull/1).
       - docker_network - no longer returns ``ansible_facts`` (https://github.com/ansible-collections/community.docker/pull/1).
       - docker_network - the ``ipam_options`` option has been removed. Use ``ipam_config``
@@ -213,11 +213,11 @@ releases:
         comparison (https://github.com/ansible-collections/community.docker/issues/85).
       - docker_image - prevent module failure when removing image that is removed
         between inspection and removal (https://github.com/ansible-collections/community.docker/pull/87).
-      - docker_image - prevent module failure when removing non-existant image by
+      - docker_image - prevent module failure when removing non-existent image by
         ID (https://github.com/ansible-collections/community.docker/pull/87).
       - docker_image_info - prevent module failure when image vanishes between listing
         and inspection (https://github.com/ansible-collections/community.docker/pull/87).
-      - docker_image_info - prevent module failure when querying non-existant image
+      - docker_image_info - prevent module failure when querying non-existent image
         by ID (https://github.com/ansible-collections/community.docker/pull/87).
       minor_changes:
       - docker_container - add ``storage_opts`` option to specify storage options
@@ -475,7 +475,7 @@ releases:
         module (https://github.com/ansible-collections/community.docker/pull/243,
         https://github.com/ansible-collections/community.docker/issues/242).
       - nsenter connection plugin - ensure the ``nsenter_pid`` option is retrieved
-        in ``_connect`` instead of ``__init__`` to prevent a crasher due to bad initialization
+        in ``_connect`` instead of ``__init__`` to prevent a crash due to bad initialization
         order (https://github.com/ansible-collections/community.docker/pull/249).
       - nsenter connection plugin - replace the use of ``--all-namespaces`` with specific
         namespaces to support compatibility with Busybox nsenter (used on, for example,
@@ -528,7 +528,7 @@ releases:
   2.2.0:
     changes:
       bugfixes:
-      - docker_container, docker_image - adjust image finding code to pecularities
+      - docker_container, docker_image - adjust image finding code to peculiarities
         of ``podman-docker``'s API emulation when Docker short names like ``redis``
         are used (https://github.com/ansible-collections/community.docker/issues/292).
       minor_changes:
@@ -791,7 +791,7 @@ releases:
         with ansible-core 2.12+. For ansible-core 2.11, uses ``distutils.version``
         for Python < 3.12. There is no support for ansible-core 2.11 with Python 3.12+
         (https://github.com/ansible-collections/community.docker/pull/271).
-      - socker_handler and socket_helper module utils - improve Python forward compatibilty,
+      - socker_handler and socket_helper module utils - improve Python forward compatibility,
         create helper functions for file blocking/unblocking (https://github.com/ansible-collections/community.docker/pull/415).
       release_summary: First alpha prerelease of community.docker 3.0.0. This version
         has several breaking changes and features rewrites of several modules to directly