-
Notifications
You must be signed in to change notification settings - Fork 0
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Clarify "Learner's Phase" table #70
Comments
I don't see the exact phases in the "Learner's Phase" table in https://www.divio.com/blog/documentation/, so perhaps it's an extrapolation by @JordanMartinez. If that's the case, we have more flexibility when clarifying it. |
The X-Y graph I was referring to is the last image in that post. The top-left corner reads " Also, due to the influence of "Teach, don't tell," our table added a fifth type, which takes one of their types and breaks it down into two types. |
When I initially wrote that part, I thought about re-creating their image using HTML tables but decided against it for two reasons:
|
I, and perhaps @JordanMartinez also, feel that the "Learner's Phase" table in the Context/Narrative document is a little wrong in its "abstraction" of the issue. What exactly is "off" about it isn't clear, so the resolution is also not clear.
Perhaps the problem is simply that I am wanting it to be something that it isn't trying to be. For example, perhaps I want it to describe the various audiences the documentation needs to address, whereas the table is simply trying to describe the various types of documentation and invents a persona to which it is most valuable.
Motivated by this thread: https://github.com/chexxor/purescript-documentation-discussion/pull/50/files#r277185921
The text was updated successfully, but these errors were encountered: