Docs: advertize .yaml suffix instead of .yml (close #498)

invoke/config.py

@@ -697,7 +697,7 @@ def load_system(self, merge=True):
         Load a system-level config file, if possible.
 
         Checks the configured ``_system_prefix`` path, which defaults to
-        ``/etc``, and will thus load files like ``/etc/invoke.yml``.
+        ``/etc``, and will thus load files like ``/etc/invoke.yaml``.
 
         :param bool merge:
             Whether to merge the loaded data into the central config. Default:
@@ -714,7 +714,7 @@ def load_user(self, merge=True):
         Load a user-level config file, if possible.
 
         Checks the configured ``_user_prefix`` path, which defaults to ``~/.``,
-        and will thus load files like ``~/.invoke.yml``.
+        and will thus load files like ``~/.invoke.yaml``.
 
         :param bool merge:
             Whether to merge the loaded data into the central config. Default:
@@ -736,7 +736,7 @@ def load_project(self, merge=True):
 
         Thus, if one were to run the CLI tool against a tasks collection
         ``/home/myuser/code/tasks.py``, `load_project` would seek out files
-        like ``/home/myuser/code/invoke.yml``.
+        like ``/home/myuser/code/invoke.yaml``.
 
         :param bool merge:
             Whether to merge the loaded data into the central config. Default:

sites/docs/concepts/configuration.rst

@@ -162,7 +162,7 @@ For each configuration file location mentioned in the previous section, we
 search for files ending in ``.yaml``, ``.yml``, ``.json`` or ``.py`` (**in that
 order!**), load the first one we find, and ignore any others that might exist.
 
-For example, if Invoke is run on a system containing both ``/etc/invoke.yml``
+For example, if Invoke is run on a system containing both ``/etc/invoke.yaml``
 *and* ``/etc/invoke.json``, **only the YAML file will be loaded**. This helps
 keep things simple, both conceptually and in the implementation.
 

sites/docs/concepts/namespaces.rst

@@ -138,7 +138,7 @@ or collection names are interpreted to be dashes instead, by default::
 If you'd prefer the underscores to remain instead, you can update your
 configuration to set ``tasks.auto_dash_names`` to ``False`` in one of the
 non-runtime :ref:`config files <config-files>` (system, user, or project.) For
-example, in ``~/.invoke.yml``::
+example, in ``~/.invoke.yaml``::
 
     tasks:
         auto_dash_names: false