Logo Start My Education

Explain Your Work Clearly.

Digital writing and portfolio lessons for creators who want their decisions to be understood

Five Parts of a Useful Project Explanation

Context

Name the audience, problem, starting condition, role, date, and constraints. Readers should understand why the project exists before seeing the solution.

Read the lesson

Decisions

Describe meaningful alternatives and why one fit the situation. A tool list is less useful than the reasoning behind each choice.

Read the lesson

Evidence

Connect claims to tests, measurements, feedback, source notes, or before-and-after comparisons. Explain how evidence was collected.

Read the lesson

Attribution

Identify your contribution and credit research, design, code, art, testing, feedback, and outside resources.

Read the lesson

Reflection

Explain what changed, what failed, what remains limited, and what you would do next. Accurate boundaries improve credibility.

Read the lesson

> Build a Credible Case Study

Begin with a one-sentence summary containing the project, audience, and result. Describe the situation before your work and the constraints that shaped real choices. Select decisions that reveal how you think instead of publishing a chronological dump.

> Replace Claims with Demonstrations

Words such as intuitive, fast, innovative, and user-friendly need support. Describe the task completed, comparison performed, error observed, or feedback that caused a revision. Without measurements, use precise modest language rather than inventing numbers.

> Revise for Someone Who Was Not There

Define specialized terms on first use and give each paragraph one main job. Descriptive headings help readers scan. Link text should describe its destination, and screenshots need captions explaining what evidence the reader should notice.

> Publish the Actual Status

Label work accurately as a concept, personal experiment, class assignment, prototype, client project, or production release. Do not imply employers, users, partnerships, awards, or outcomes that did not occur. For team work, state what you owned and where you collaborated.

> Practice Outline

Write: summary; audience and problem; constraints; your role; two important decisions; evidence; result; limitations; next step; and credits. Then underline every important claim and identify the evidence supporting it.

> Make Images and Links Useful

A screenshot should support a nearby explanation rather than replace it. Add a caption telling the reader what to notice, provide meaningful alternative text, and remove private information. Use descriptive link text so the destination makes sense without relying on surrounding sentences.

> Final Revision Pass

Read the draft once for missing context, once for unsupported claims, and once for accessibility. Remove repeated background, define unexplained terms, verify names and dates, test every link, and ask whether the conclusion matches the evidence actually shown.

Collage

Support Us!

Note: It’s not required, but it does help a lot.

A clear project story lets readers distinguish what you observed, what you decided, and what remains uncertain.
– Digital writing practice note