Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Community Proposals
Community Proposals
tag:snake search within a tag
answers:0 unanswered questions
user:xxxx search by author id
score:0.5 posts with 0.5+ score
"snake oil" exact phrase
votes:4 posts with 4+ votes
created:<1w created < 1 week ago
post_type:xxxx type of post
Search help
Notifications
Mark all as read See all your notifications »
Q&A

Post History

71%
+3 −0
Q&A What is Documentation Design that I haven't already done?

I have no clue what he meant by designed. But I agree with him that you have not designed the documentation. Why? Because you have not created a list of user tasks. Documentation is a response t...

posted 5y ago by Mark Baker‭

Answer
#1: Initial revision by user avatar Mark Baker‭ · 2020-01-31T23:33:58Z (almost 5 years ago)
I have no clue what he meant by designed. But I agree with him that you have not designed the documentation.

Why? Because you have not created a list of user tasks. 

Documentation is a response to a theory about what users want to do. Its purpose is to assist them in doing the things they want to do. If you don't have a theory about what users want to do, you don't have a useful documentation design. 

Of course, this can be difficult. Interviewing end users is a start, but what did you interview them about? What you want to know from users is: what tasks do you want to accomplish, what do you know now, what do you call things, and how do you do those tasks now (if you already do them)? 

That is the information you need to write documentation that assists them in doing the things they want to do. If you don't have that information and a plan to provide it, you don't have a documentation design. 

Now it is true that your documentation will have to use a particular font for heading and for body text, and it is not a bad idea if you are consistent in a bunch of stylistic questions. But these things are just the design of the document, not of the documentation. It's fine to have that stuff, but it does not tell you what tasks you are supporting and how you can best support them. 

To design the documentation, you need a theory of the user's tasks and of who they are, what they know, and how they currently do things, and a plan to support them in completing their tasks in your tool. Till you have that, you may have a document design, but you don't have documentation design.