add docs guides

avo-hq · Jan 15, 2025 · 5c85b7f · 5c85b7f
1 parent 458e1b1
commit 5c85b7f
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/readme.md b/readme.md
@@ -50,3 +50,8 @@ On top of the page.
 outline: [2,3] # shows the h2's and h3's
 outline: deep # shows the h2's all the way to h6
 ```
+
+## Write better docs
+
+- [diataxis.fr/](https://diataxis.fr/)
+- [refactoringenglish.com/chapters/rules-for-software-tutorials/](https://refactoringenglish.com/chapters/rules-for-software-tutorials/)