update doc

README.md

@@ -91,12 +91,12 @@ See the [installation instructions](https://dotdrop.readthedocs.io/en/latest/ins
 
 Dotdrop is available on:
 
-* PyPI: https://pypi.org/project/dotdrop/
+* [PyPI](https://pypi.org/project/dotdrop/)
-* Homebrew: https://formulae.brew.sh/formula/dotdrop
+* [Homebrew](https://formulae.brew.sh/formula/dotdrop)
-* AUR (stable): https://aur.archlinux.org/packages/dotdrop/
+* [AUR (stable)](https://aur.archlinux.org/packages/dotdrop/)
-* AUR (git version): https://aur.archlinux.org/packages/dotdrop-git/
+* [AUR (git version)](https://aur.archlinux.org/packages/dotdrop-git/)
-* Snapcraft: https://snapcraft.io/dotdrop
+* [Snapcraft](https://snapcraft.io/dotdrop)
-* pacstall: https://github.com/pacstall/pacstall-programs/blob/master/packages/dotdrop/dotdrop.pacscript
+* [Pacstall](https://github.com/pacstall/pacstall-programs/blob/master/packages/dotdrop/dotdrop.pacscript)
 
 # Getting started
 

docs/config-config.md

@@ -1,4 +1,4 @@
-# Config entry
+# Config block
 
 The **config** entry (mandatory) contains global settings.
 

docs/config-dotfiles.md

@@ -1,4 +1,4 @@
-# Dotfiles entry
+# Dotfiles block
 
 The **dotfiles** entry (mandatory) contains a YAML object with sub-objects for the dotfiles managed by dotdrop.  The entries in the sub-objects are as follows:
 

docs/config-file.md

@@ -295,7 +295,7 @@ dotfiles:
 Dotdrop should be able to handle `toml` config file however this
 feature hasn't been extensively tested. A base [config.toml](/config.toml) is available to get started.
 
-The script ([yaml-to-toml.py](/scripts/yaml-to-toml.py)) allows to convert a `yaml` dotdrop
+The script [yaml-to-toml.py](/scripts/yaml-to-toml.py) allows to convert a `yaml` dotdrop
 config file to `toml`.
 
 For more see issue [#343](https://github.com/deadc0de6/dotdrop/issues/343).

docs/installation.md

@@ -1,11 +1,11 @@
 # Installation
 
-* PyPI: https://pypi.org/project/dotdrop/
+* [PyPI](https://pypi.org/project/dotdrop/)
-* Homebrew: https://formulae.brew.sh/formula/dotdrop
+* [Homebrew](https://formulae.brew.sh/formula/dotdrop)
-* AUR (stable): https://aur.archlinux.org/packages/dotdrop/
+* [AUR (stable)](https://aur.archlinux.org/packages/dotdrop/)
-* AUR (git version): https://aur.archlinux.org/packages/dotdrop-git/
+* [AUR (git version)](https://aur.archlinux.org/packages/dotdrop-git/)
-* Snapcraft: https://snapcraft.io/dotdrop
+* [Snapcraft](https://snapcraft.io/dotdrop)
-* pacstall: https://github.com/pacstall/pacstall-programs/blob/master/packages/dotdrop/dotdrop.pacscript
+* [Pacstall](https://github.com/pacstall/pacstall-programs/blob/master/packages/dotdrop/dotdrop.pacscript)
 
 ## As a submodule
 

mkdocs.yml

@@ -15,14 +15,14 @@ nav:
   - 'Usage': 'usage.md'
   - 'Config':
     - 'Config file': 'config-file.md'
-    - 'Config': 'config-config.md'
+    - 'Config block': 'config-config.md'
-    - 'Dotfiles': 'config-dotfiles.md'
+    - 'Dotfiles block': 'config-dotfiles.md'
-    - 'Profiles': 'config-profiles.md'
+    - 'Profiles block': 'config-profiles.md'
-    - 'Actions': 'config-actions.md'
+    - 'Actions block': 'config-actions.md'
-    - 'Transformations': 'config-transformations.md'
+    - 'Transformations block': 'config-transformations.md'
-    - 'Variables': 'config-variables.md'
+    - 'Variables block': 'config-variables.md'
-    - 'Dynvariables': 'config-dynvars.md'
+    - 'Dynvariables block': 'config-dynvars.md'
-    - 'Uservariables': 'config-uservars.md'
+    - 'Uservariables block': 'config-uservars.md'
   - 'Templating':
     - 'Templating': 'templating.md'
   - 'More':