Add some ideas for missing documentation pages
Marco Ricci commited on 2024-10-04 10:59:28
Zeige 1 geänderte Dateien mit 21 Einfügungen und 0 Löschungen.
These are likely documentation entries that are anticipated, and yet uncovered. This includes most of the "hard" stuff: tutorials and how-tos. (The reference part is easy, and the explanation part only slightly less so.)
- docs/_future.md 0000000..3fb64ed
| ... | ... |
@@ -0,0 +1,21 @@ |
| 1 |
+# Some ideas for documentation that might be missing, or nice to have |
|
| 2 |
+ |
|
| 3 |
+(Categorized as per [the diataxis framework][DIATAXIS], but otherwise in no particular order.) |
|
| 4 |
+ |
|
| 5 |
+ |
|
| 6 |
+[DIATAXIS]: https://diataxis.fr |
|
| 7 |
+ |
|
| 8 |
+## Tutorials |
|
| 9 |
+ |
|
| 10 |
+* Setting up `derivepassphrase` from scratch for three existing accounts, with a master passphrase |
|
| 11 |
+* Setting up `derivepassphrase` from scratch for three existing accounts, with a new SSH key |
|
| 12 |
+ |
|
| 13 |
+## How-tos |
|
| 14 |
+ |
|
| 15 |
+* How to set up `derivepassphrase` with an SSH key |
|
| 16 |
+* How to choose a good service name |
|
| 17 |
+ |
|
| 18 |
+## Explanation |
|
| 19 |
+ |
|
| 20 |
+* Security aspects and other tradeoffs when using deterministic password generators |
|
| 21 |
+* Tradeoffs between a master passphrase and a master SSH key |
|
| 0 | 22 |