Post History
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...
Answer
#1: Initial revision
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.