Merge pull request #154 from twpayne/advantages

Document reasons for using chezmoi in README.md

Author: twpayne

README.md

@@ -9,38 +9,42 @@ Manage your dotfiles securely across multiple machines.
 
 ## Features
 
- * Declarative: you declare the desired state of files, directories, and
-   symbolic links in your home directory and `chezmoi` updates your home
-directory to match that state.
-
- * Flexible: your dotfiles can be templates (using
-   [`text/template`](https://godoc.org/text/template) syntax). Predefined
-variables allow you to change behaviour depending on operating system,
-architecture, and hostname.
-
  * Secure: `chezmoi` can retreive secrets from
    [1Password](https://1password.com/), [Bitwarden](https://bitwarden.com/),
 [LastPass](https://lastpass.com/), [pass](https://www.passwordstore.org/),
 [Vault](https://www.vaultproject.io/), your Keychain (on macOS), [GNOME
 Keyring](https://wiki.gnome.org/Projects/GnomeKeyring) (on Linux), or any
-command-line utility of your choice.
+command-line utility of your choice. You can checkout your dotfiles repo on as
+many machines as you want without revealing any secrets to anyone.
 
- * Robust: `chezmoi` updates all files and symbolic links atomically (using
-   [`google/renameio`](https://github.com/google/renameio)) so you are never
-left with incomplete files that could lock you out, even if the update process
-is interrupted.
+ * Flexible: your dotfiles can be templates (using
+   [`text/template`](https://godoc.org/text/template) syntax). Predefined
+variables allow you to change behaviour depending on operating system,
+architecture, and hostname. You can share as much configuration across machines
+as you want, while still being able to control machine-specific details.
 
- * Portable: `chezmoi`'s configuration uses only visible, regular files and
-   directories and so is portable across version control systems and operating
-systems.
+ * Personal: Nothing leaves your machine, unlesss you want it to. You can use
+   the version control system of your choice to manage your configuration, and
+you can write the configuration file in the format of your choice.
 
  * Transparent: `chezmoi` includes verbose and dry run modes so you can review
    exactly what changes it will make to your home directory before making them.
+`chezmoi`'s source format uses only regular files and directories that map
+one-to-one with the files, directories, and symlinks in your home directory
+that you choose to manage. If you decide not to use `chezmoi` in the future,
+it is easy to move your data elsewhere.
+
+ * Robust: `chezmoi` updates all files and symbolic links atomically (using
+   [`google/renameio`](https://github.com/google/renameio)). You will never be
+left with incomplete files that could lock you out, even if the update process
+is interrupted.
+
+ * Declarative: you declare the desired state of files, directories, and
+   symbolic links in your home directory and `chezmoi` updates your home
+directory to match that state. What you want is what you get.
 
- * Fast, easy to use, and familiar: `chezmoi` runs in fractions of a second and
-   includes commands to make most operations trivial. You can use the version
-control system of your choice to manage your configuration, and many different
-formats (e.g. JSON, YAML, TOML, etc.) are supported for the configuration file.
+ * Fast and easy to use: `chezmoi` runs in fractions of a second and makes most
+   day-to-day operations one line commands.
 
 
 ## I already have a system to manage my dotfiles, why should I use `chezmoi`?