Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .knowledgeBank/diataxis/tutorials.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ At every step of a tutorial, the user experiences a moment of anxiety: will this

Keep up a narrative of expectations: "You will notice that …"; "After a few moments, the server responds with …". Show the user actual example output, or even the exact expected output.

If you know know in advance what the likely signs of going wrong are, consider flagging them: "If the output doesn't show …, you have probably forgotten to …".
If you know in advance what the likely signs of going wrong are, consider flagging them: "If the output doesn't show …, you have probably forgotten to …".

It's helpful to prepare the user for possibly surprising actions: "The command will probably return several hundred lines of logs in your terminal."

Expand Down