Session 04: Drafting the Instructions
Hey, hey! Welcome to this session of the Content Review Decision Tree project where I am creating a tool to determine when review support is needed and at what capacity. In the previous two sessions I established an algorithm for the triggers for the three identified support types – for projects and updates. In this session I plan on writing the official introduction / instructions.
I’m just going to dive in and see what happens:
Review Support Tool
The purpose of this tool is to determine when each review tier is needed before implementing content. Three review tiers have been identified:
- Conceptual Support: Trusted confidants who understand the goal, reliable, and who freely question better ways to meet your goal.
- Target Audience Support: Users for which the content was designed for who do not necessarily need to understand the goal or be known by the project producer.
- Proofread Support: Editors who have an eye for typos, grammar, sentence structure, etc. who do not necessarily need to understand the goal or be known by the project producer.
Before using the tool, you will need to identify the type of project you are working on based on the following parameters:
- Is the content INFORMAL or FORMAL?
- Informal: The presentation is intended for a more relaxed audience.
- Formal: The presentation needs to come off as professional.
- Is the content INFORMATIONAL or CONCEPTUAL?
- Informational: The content is more about reporting data.
- Conceptual: The content is more about stirring emotion or ideas.
- Is the content intended solely for an INTERNAL AUDIENCE?
- Yes: The intended audience is specifically for Cryptiquest or those employed / contracted by Cryptiquest.
- No: Even if the intended audience is mostly for Cryptiquest or those employed / contracted by Cryptiquest, there is at least a small part intended for an external audience.
With your project identified, you can determine what tiers of review support is needed for the content by running this algorithm:
- Is the content Informal?
- Yes: No review support needed
- No: Go to Question 2.
- Is the content a new project or an update?
- New Project: Go to Question 3.
- Update: Go to Question 5.
- Is the content Informational or Conceptual?
- Informational: You only need Proofread Support.
- Conceptual: Go to Question 4.
- Is the content solely intended for an Internal Audience?
- Yes: You need Conceptual Support and Proofread Support.
- No: You need Conceptual Support, Target Audience Support, and Proofread Support.
- Is the content Informational or Conceptual?
- Informational: Go to Question 6.
- Conceptual: Go to Question 7.
- Do the updates entail complete rewrites?
- Yes: You only need Proofread Support.
- No: No review support needed.
- Do the updates bend the concepts enough that they are completely different from before?
- Yes: You need Conceptual Support, Target Audience Support, and Proofread Support.
- No: Go to Question 6.
If it is not obvious, you can override the results of this tool and choose to forgo review support or seek review support however you wish. This tool was generated to help you determine the decision.
I think that’s good for a first draft. I might switch question 6 and 7 around in the algorithm so that users aren’t having to go back a question (that’s weird). But if I do that then I should also reverse the order of answers for question 5 so the Go to statements aren’t backwards. But if I do that then for consistency, do I need to reverse the order of answers in question 3? Probably not. Consistency in presentation probably isn’t important for something that’s intended to be read as an algorithm. Clarity in instruction is the top priority.
- Is the content Informal?
- Yes: No review support needed
- No: Go to Question 2.
- Is the content a new project or an update?
- New Project: Go to Question 3.
- Update: Go to Question 5.
- Is the content Informational or Conceptual?
- Informational: You only need Proofread Support.
- Conceptual: Go to Question 4.
- Is the content solely intended for an Internal Audience?
- Yes: You need Conceptual Support and Proofread Support.
- No: You need Conceptual Support, Target Audience Support, and Proofread Support.
- Is the content Conceptual or Informational?
- Conceptual: Go to Question 6.
- Informational: Go to Question 7.
- Do the updates bend the concepts enough that they are completely different from before?
- Yes: You need Conceptual Support, Target Audience Support, and Proofread Support.
- No: Go to Question 7.
- Do the updates entail complete rewrites?
- Yes: You only need Proofread Support.
- No: No review support needed.
That’s better.
The next step is to prepare this for review. I’ve identified that this project falls under Question 4: Yes for review needs, which requests Conceptual Support and Proofread Support. The next session will be dedicated to review so I’ll work that all out there. See you there!
Action Items
- N/A