diff --git a/knowledge base/chezmoi.md b/knowledge base/chezmoi.md
index 918cd11..6f224ef 100644
--- a/knowledge base/chezmoi.md
+++ b/knowledge base/chezmoi.md
@@ -9,7 +9,7 @@ A multi-machine dotfile manager, written in Go.
1. [Gotchas](#gotchas)
1. [Snippets](#snippets)
1. [Further readings](#further-readings)
-1. [Sources](#sources)
+ 1. [Sources](#sources)
## TL;DR
@@ -132,22 +132,20 @@ $
- [Go text/template]
- [Sprig]
-## Sources
-
-All the references in the [further readings] section, plus the following:
+### Sources
+- [Source state attributes]
- [cheat.sh]
-- [custom data fields appear as all lowercase strings]
+- [Custom data fields appear as all lowercase strings]
-[further readings]: #further-readings
-
[user guide]: https://www.chezmoi.io/user-guide/setup/
+[source state attributes]: https://www.chezmoi.io/reference/source-state-attributes/
[cheat.sh]: https://cheat.sh/chezmoi
diff --git a/knowledge base/shellcheck.md b/knowledge base/shellcheck.md
index ac98e5a..bf5ae53 100644
--- a/knowledge base/shellcheck.md
+++ b/knowledge base/shellcheck.md
@@ -2,26 +2,47 @@
Gives warnings and suggestions about `bash`/`sh` shell scripts.
-## Table of contents
-
1. [TL;DR](#tldr)
1. [Further readings](#further-readings)
## TL;DR
+
+ Installation and configuration
+
```sh
-shellcheck /path/to/script.sh
+apt install 'shellcheck'
+brew install 'shellcheck'
+pacman -S 'shellcheck'
+zypper in 'ShellCheck'
```
+
+
+ Usage
+
+```sh
+shellcheck '/path/to/script.sh'
+shellcheck '/path/to/scripts/*.sh'
+```
+
+
+
## Further readings
- [Website]
- [Github]
+
+
+
[github]: https://github.com/koalaman/shellcheck
[website]: https://www.shellcheck.net/
+
+