Agreed.

--
Pedro Algarvio @ phone

----- Reply message -----
De: "Joseph Hall" <notifications@github.com>
Para: "saltstack/salt-cloud" <salt-cloud@noreply.github.com>
Cc: "Pedro Algarvio" <pedro@algarvio.me>
Assunto: [salt-cloud] Enforce the new providers configuration. Refs #239 (#494)
Data: sex, Abr 5, 2013 21:06
In doc/topics/aws.rst: 
>   
>  .. code-block:: yaml 
>   
>      EC2.delvol_on_destroy: True 
>   
>   
> -The setting for this may be changed on an existing instance using one of the 
> +* Using the new cloud configuration format: 
> + 
> +.. code-block:: yaml 
> + 
> +    ec2-config: 

I would prefer to avoid using the name of the provider in the example config, unless it is required. If you have to use it, I would add a word that makes it obvious that it's custom text, such as my-ec2-config or pedro-ec2-config. It's too easy to take such pieces of documentation too literally. 

&mdash;
Reply to this email directly or view it on GitHub.