Add note to README about JSON parsing
Casey Rodarmor <casey@rodarmor.com> pointed out that Dotbot parses JSON files as YAML. The YAML format doesn't allow tab characters, which are normally allowed in JSON. This patch adds a note about this to the README.
This commit is contained in:
parent
5babc8f562
commit
57265f78b4
1 changed files with 10 additions and 5 deletions
15
README.md
15
README.md
|
@ -109,12 +109,17 @@ The conventional name for this file is `install.conf.json`.
|
||||||
]
|
]
|
||||||
```
|
```
|
||||||
|
|
||||||
## Configuration
|
Configuration
|
||||||
|
-------------
|
||||||
|
|
||||||
Dotbot uses YAML or JSON formatted configuration files to let you specify how to
|
Dotbot uses YAML or JSON formatted configuration files to let you specify how
|
||||||
set up your dotfiles. Currently, Dotbot knows how to [link](#link) files and
|
to set up your dotfiles. The YAML format is recommended because it looks
|
||||||
folders, execute [shell](#shell) commands, and [clean](#clean) directories of
|
cleaner. JSON will be parsed as a subset of YAML, so tab characters are not
|
||||||
broken symbolic links.
|
permitted.
|
||||||
|
|
||||||
|
Currently, Dotbot knows how to [link](#link) files and folders, execute
|
||||||
|
[shell](#shell) commands, and [clean](#clean) directories of broken symbolic
|
||||||
|
links.
|
||||||
|
|
||||||
**Ideally, bootstrap configurations should be idempotent. That is, the
|
**Ideally, bootstrap configurations should be idempotent. That is, the
|
||||||
installer should be able to be run multiple times without causing any
|
installer should be able to be run multiple times without causing any
|
||||||
|
|
Loading…
Reference in a new issue