Studio Aletheia Presents · Clarity by Design
Portfolio Curriculum
Technical Writing for Instructional Clarity
A 7-Project Portfolio Pathway on the Aletheian Design Theory of Learning
Technical writing is fundamentally about making thinking visible: not prose beauty, but clarity, structure, audience awareness, and decision-making. Every technical writer carries the same responsibility, your design guidance must work without your presence.
Guiding stance: Direction Defined. Coherence Preserved.
Core move: design instructional artifacts, test them under real conditions, then revise based on outcomes.
Success signal: design guidance that works without you in the room.
Six design phases guide the whole pathway, from first orientation to demonstrated mastery.
The Aletheian Design Theory of Learning
Six phases shape every project in this pathway, from first orientation to demonstrated mastery.
Orientation
Learners are oriented into the design challenge and its purpose. The work must feel meaningful before it feels instructional. Context, role, and stakes are established so learners understand why the work exists and who they are becoming through it.
Exploration
Learners examine examples, gather inputs, and test ideas safely. Observation, trial, and early evidence are collected without penalty. Confusion is expected and protected.
Synthesis
Learners consolidate findings, name patterns, and form defensible understanding. Fragmented insights are shaped into a coherent model that can be explained and justified.
Application
Learners transfer the model into a new context or challenge. Understanding is demonstrated through use, adaptation, and decision-making, not recall alone.
Reflection
Learners evaluate decisions and outcomes, identify what improved clarity or meaning, and articulate revisions that would strengthen impact.
Mastery
Learners demonstrate durable understanding by explaining, defending, and transferring their thinking with clarity, evidence, and design rationale.
Before you begin.
This portfolio asks you to design content that must work for other people. Not to impress, to work. You will design instruction that operates without you, and when something falls short, the responsibility for improving it is yours.
- Do the project first and finish it fully.
- Only upon completion should you use the Comparison Card.
- Moving ahead too early in the process weakens the work, even if it feels efficient.
- What you notice changing
- What you stop assuming
- What you revise without being asked
- You will revise often, some revisions will feel obvious, others will feel unnecessary.
- Do not rank revisions by confidence, the resisted ones often matter most.
- Do not add more explanation.
- Do not make things louder.
- Do not simplify prematurely.
- Pause and look at structure, order, and emphasis.
Notes are fragments, not journals. Use short phrases. Do not organize them yet. Their meaning will emerge later.
When This Work Will Make SenseNear the end, earlier decisions in your journey through this curriculum will suddenly feel connected. Do not hunt for that moment. If you do the work as it is designed, it arrives on its own.
Seven projects that build technical writing and instructional design skill.
Each project pairs a Project Brief with a Comparison Card. Do the work first, then use the Comparison Card to calibrate and revise.
The Invisible Guide
Human-Facing Instructional Clarity
Design a set of instructions for a task you already know how to do, then test it without defending it. The difficulty is cognitive: making your thinking visible without explaining it directly.
You are designing for absence. The user cannot ask questions, watch you, or infer intent.
- Choose a task you can do reliably, with a clear end state, under 15 minutes.
- Do it once without writing, then again while stopping after every action to record what you do.
- Rewrite steps so each depends only on what has already occurred.
- Make judgment and sensory reliance visible (sight, sound, pressure, timing).
- Instructions must fit on a single page.
- Use spacing, grouping, and sequencing to carry meaning.
- Signal irreversible steps before they occur.
- No decoration, every visual choice reduces decision-making.
- Predict at least three plausible misunderstandings.
- Diagnose: missing info, poor sequencing, unclear language.
- Revise to address at least one failure directly.
- Test with another person, or simulate by following your guide exactly.
- No explaining, gesturing, or intervening.
- Observe hesitation, confusion, confidence drops, then revise again.
- Be able to explain what your instructions prioritize and ignore.
- Be able to name where they fail under stress.
- Capture trust boundaries: what you trust most, least, what you would test next.
In this curriculum, comparison is a measurement of effectiveness. It is not presented for inspiration in the artistic sense. Review each Comparison Set and record what each artifact makes easy, difficult, and who struggles first when conditions change.
Comparison Set A: Speed Versus Comprehension- Compressed steps and assumed momentum
- Separated steps and enforced pause
- Apparent efficiency that hides a dependency
- Assumptions stated explicitly
- Assumptions embedded invisibly
- Over-specification that creates friction
- Anticipates failure and offers recovery paths
- Prevents failure through rigid sequencing
- Relies on the learner to self-correct
Use your Design Log and Comparison Log to write three statements: one design choice to keep, one to change, one risk you missed before comparison.
Revision CommitmentMake one structural revision (order, grouping, emphasis, omission). Do not add length unless it reduces decision-making. Record what changed, why, and what you expect to improve.
Audience Under the Microscope
Clarity Collapses When Audiences Are Treated as Interchangeable
Redesign your Project 1 instructions for two plausible audiences with different constraints. This is not about tone, it is structural alignment.
Return to Project 1, do not revise yet. Examine how it behaves when the reader changes.
Select two audiences who differ in at least two of these: prior knowledge, emotional state, stakes of failure, environmental context.
- List what Audience A notices first (max 5 items)
- List what Audience B notices first (max 5 items)
Redesign for Audience A, then for Audience B. Do not reuse structure blindly.
- Where does each audience hesitate?
- Where do they need reassurance, where do they need restraint?
- If versions look similar at a glance, revise again.
Identify one likely failure for each audience, revise each version to address that failure directly.
05: Internal ComparisonPlace both versions side by side and record trade-offs: gains and losses for each audience.
06: Preparing for External ComparisonBe ready to articulate how audience assumptions shaped structure, where it protected, where it constrained.
Diagnose miscalibration that is almost right. Record who the artifact thinks it is for, who it actually serves, and where the first crack appears.
Set A: Overestimating the Learner- Assumes confidence where uncertainty exists
- Supports beginners but removes agency
- Appears neutral but embeds expert shortcuts
- Explanation becomes noise
- Optional depth paths exist but are not signaled
- Autonomy is mistaken for clarity
- Assumes calm attention
- Assumes high stakes and designs for caution
- Assumes learner will self-adjust
Choose one audience version, make one structural change (pacing, branching, emphasis, omission), then record the corrected assumption, the change, and the signal you expect to improve.
Failure Is the Curriculum
Design for Miscalibration Under Stress
Stress reveals weaknesses that never appear during calm use. You will design a recovery intervention that restores forward motion with minimal decision-making.
Return to one audience version from Project 2. Audience stays the same, condition changes.
- List realistic stressors
- How stress changes attention or behavior
- Which part of your design is most vulnerable
Identify a failure likely only under stress (skipping a step, misreading emphasis, abandoning prematurely). Locate where your design lets it pass unnoticed.
03: Mis-calibrated Responses- Overloading with explanation
- Withdrawing guidance entirely
- Repeating information without reframing
- Insert one recovery moment exactly where failure is likely.
- Use calmer, simpler language than main flow.
- Reduce choices rather than add them.
Simulate time limits, distraction, or "perform after a mistake." Follow instructions exactly, observe whether recovery is noticed and effective.
06: Preparing for ComparisonBe able to explain what your design assumes about stress, where it supports, where it would still fail.
Compare failure behavior. Ask which design fails first under stress.
Set A: Overestimating Composure- Assumes learner can slow themselves down
- Enforces pacing through structure
- Assumes rereading when confused (rare under stress)
- Heavy guidance that overwhelms
- Narrowed options that help or harm
- Avoids panic directly
- Recovery appears too late
- Recovery appears too early
- Recovery embedded invisibly into flow
Make one final structural revision focused on stress response, record what changed, why, and what stress behavior it targets.
Visual Meaning, Not Decoration
Hierarchy Is Behavior Under Pressure
Visual hierarchy makes promises about attention, pacing, and re-entry. You will redesign hierarchy without changing content, so the eye obeys what the learner needs first.
Return to revised Project 3 artifact and observe what the page appears to value at first glance.
02: Locating Visual Mis-calibration- Important steps minimized
- Secondary info dominates
- Groupings imply false equivalence
Adjust spacing, grouping, order, emphasis. No decoration. Design for glance before action.
04: Hierarchy Under InterruptionPause mid-task, return after a delay. If page does not guide re-entry, revise for resumption without rereading.
05: Aligning Hierarchy to AudienceRe-examine Project 2 assumptions, ask what the layout assumes: confidence or caution, scanning or careful reading, panic protection or amplification.
06: Preparing for ComparisonBe able to articulate what hierarchy optimizes for, what it sacrifices, where it still fails under pressure.
Examine sets without reading text first. Record first attention, second attention, and critical element delayed.
Set A: False Emphasis- Reassurance elevated over action
- Action elevated but context hidden
- Balance achieved but recovery cues delayed
- Multiple elements treated as equally important
- Single dominant priority enforced
- Priority staggered across time
- Assumes calm scanning
- Assumes panic-driven fixation
- Assumes interruption and return
Make one final hierarchy adjustment. Do not add content. Change only what the eye obeys, then record what moved, why, and what behavior it supports.
Instruction as a System
Design Coherence Across Multiple Artifacts
Instruction does not live alone. You will design a coordinated set of artifacts where handoffs, hierarchy, and responsibility remain coherent across the system.
Work with three artifacts for the same task (setup, usage, troubleshooting or reminder). Examine how they function together.
02: Mapping the Instructional JourneyMap the learner journey including interruptions and returns. Mark where they must remember, locate info, decide what matters.
03: Locating System-Level Mis-calibration- Conflicting hierarchy between artifacts
- Repeated explanations that erode trust
- Missing handoffs where no artifact takes responsibility
Move responsibilities, remove info from one to strengthen another, re-sequence exposure rather than rewrite content.
05: Stress-Testing the SystemSimulate: user skips first artifact, returns days later, enters from wrong point. Observe what breaks first and whether recovery is possible.
06: Positioning Your SystemState what the system optimizes for, what it sacrifices, who it fails first and why. Treat this as an ethical declaration.
Review each system as a whole before reading linearly. Jump between artifacts, navigation confusion is the signal.
Set A: Conflicting Hierarchies- Safety dominates
- Speed dominates
- Both assumed simultaneously, learner forced to choose without guidance
- Each artifact over-explains
- No artifact trusts the others
- Redundancy creates fatigue and disengagement
- Artifact A ends without preparing for B
- B assumes preparation that never occurred
- C tries to compensate and fails
Make one system-level change, even if it weakens one artifact to strengthen the whole. Record what shifted, why, and what behavior improves.
Instructional Continuity and Memory
Design for Return, Resumption, Recognition
Most instruction is used later. You will redesign your system so it survives time, memory decay, interruption, and partial recall, without shame or restart pressure.
Assume the learner will leave, time will pass, and they will remember fragments, not sequences. Design for re-entry, not repetition.
02: Identifying Memory Dependencies- References to prior steps without anchors
- Concepts named once and reused later
- Visual cues that disappear between artifacts
Replace memory with recognition by repeating structural cues, maintaining visual anchors, and using predictable phrasing patterns.
04: Return Without ShameSimulate return after absence without rereading earlier artifacts. Revise to support resumption, not evaluation.
05: Memory Under StressCombine time and stress. Identify what must be instantly visible, what can be optional, what should never be hidden.
06: Continuity SnapshotState how instruction behaves after delay, what it forgives, what it demands. Continuity is an ethical stance.
Review each system twice: first-time use, then returning after one week. Do not reread between passes.
Set A: Memory Load- Sequential recall demanded
- Recognition supports action
- Mixed inconsistently (confusion emerges)
- Return assumed to equal mastery
- Return treated as restart
- Partial recall supported
- Visual anchors change across artifacts
- Anchors maintained rigidly
- Anchors adapt without losing identity
Make one continuity adjustment that improves return behavior without increasing explanation. Record what now persists, why it matters, and what behavior improves.
Professional Design Justification
Defend Design as Reasoning, Not Taste
Professional environments ask why something is structured the way it is, why alternatives were rejected, and how decisions align to audience needs, risk, and ethical responsibility.
Surface the claims embedded in your instruction: who the learner is, what they need, what matters most, what can fail safely.
- Three claims about learners
- Two claims about context
- One claim about acceptable failure
Select one language decision, one hierarchy decision, one system or continuity decision. Trace each to observed behavior, accepted constraint, and risk mitigated.
03: Anticipating CritiqueSelect two reasonable critiques (too simple, too cautious, could be shorter, assumes too much). Prepare responses without defensiveness.
04: Defending Trade-OffsWrite defenses that name trade-offs, explain who benefits, accept who does not. Use cause and effect, avoid adjectives.
05: Ethical PositioningIdentify one ethical dimension (reducing harm under stress, preventing misuse, avoiding false confidence, supporting dignity on return) and explain the design response and protected behavior.
06: Professional StatementWrite a one-paragraph justification statement that is intelligible to someone who has not seen your work: approach to clarity, audience, responsibility.
Read each justification before seeing the artifact. Decide whether you trust the designer's reasoning, then examine the artifact.
Set A: Post-Hoc Rationalization- Explains what was done, cannot explain why alternatives were rejected
- Confident language, thin reasoning
- Treats critique as attack
- Trade-offs denied or minimized
- Names constraints, trade-offs, ethical considerations
- Acknowledges imperfection, trust increases
Revise your justification statement once to improve reasoning clarity, strengthen ethical grounding, and increase professional trust. Record what changed and why it matters.
After the work.
This is not here to evaluate what you produced. It exists to help you notice how you now think, and what responsibility you now carry as a designer of instruction. Do not rush this, and do not reread earlier materials yet.
Returning to the Beginning
Read your earliest notes without judgment. Name one belief you no longer hold fully, and one assumption that now feels incomplete.
What You Now Notice First
Think about ordinary instructions you encountered recently. List three things you now notice immediately, and one you rarely notice anymore.
Revision Without Prompt
Identify changes you made without being instructed to. Name what changed and when you realized it needed to change.
Seeing the System
Finish the sentence: "I didn't realize until now that..."
One question. One defense.
Name the question you now ask before problems appear, and how you would respond if someone challenged your instructional choices.