-
Notifications
You must be signed in to change notification settings - Fork 9
IA Guide - Initial Draft #3
IA Guide - Initial Draft #3
Conversation
## Writing for your readers | ||
Now that you've had a think about who your readers are, and the kinds of things they might be using your documentation for, you can display them in a table like this: | ||
|
||
<table> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do you reckon this would translate well to Markdown or non-interactive mode?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The way I see it, those fields just need to be blank for non-interactive mode. My thinking has been that we need to be able to just remove the interactive elements, and encourage use of a pen and paper.
Wanted to be able to review and understand more the approach here with Twinery. I took a shot at running this, let me know if this was the right approach or should I use some other client. Would be helpful to have more in-depth instructions on how this should run as it will help other maintain this for the future. Or should I breakup each section into passages? am I using even the correct client? Let me know if there is a specific client I should be using. |
This is awesome! You just need to select chapbook as the format, so that the interactive bits work, I think. |
Merging this PR now that the initial draft is done. Will open a new PR for editing. |
Issue: https://github.com/thegooddocsproject/planning/issues/12
Epic: https://github.com/thegooddocsproject/planning/issues/2
cc @jaredmorgs