EXPLORE

Find a form that fits.

Browse by purpose, follow a familiar name, or discover a different way to express the same idea.

30 of 30 approaches

Approaches

Language & documentation · Standard

ASD-STE100

Make technical instructions easier to interpret through controlled language and consistent terms.

Introductory
Language & documentation · Standard-informed practice

Plain language

Help the intended reader find, understand, and use the information they need.

Introductory
Language & documentation · Framework

Diátaxis

Choose documentation around whether someone is learning or working, and doing or understanding.

Introductory
Language & documentation · Framework

Minto Pyramid Principle

Organize a business explanation around one main point supported by logically grouped reasons.

Introductory
Language & documentation · Standard

DITA

Author reusable documentation topics and assemble them for different publications.

Advanced
Learning & explanation · Method

Concept mapping

Make relationships between concepts explicit with labeled connections.

Introductory
Learning & explanation · Teaching method

Worked examples

Study a complete solution with reasons before attempting a related problem.

Introductory
Learning & explanation · Learning method

Self-explanation & teach-back

Explain a mechanism in your own words, then check the explanation against evidence.

Introductory
Learning & explanation · Method

Socratic questioning

Use focused questions to examine definitions, assumptions, evidence, and consequences.

Introductory
Learning & explanation · Interaction pattern

Progressive disclosure

Reveal detail when it becomes useful while keeping essential information easy to find.

Introductory
Architecture & structure · Model

C4 model

Explain a software architecture through a small set of consistent levels of detail.

Introductory
Architecture & structure · Modeling language

UML

Choose a defined notation for structure, interactions, activities, or state changes.

Intermediate
Architecture & structure · Modeling method

Entity–relationship modeling

Describe entities, relationships, and cardinality before designing or interpreting data.

Intermediate
Architecture & structure · Documentation template

arc42

Document architecture through a coherent set of questions about context, structure, behavior, quality, and risk.

Intermediate
Architecture & structure · Documentation convention

Architecture decision records

Preserve why a consequential choice was made and what follows from it.

Introductory
Requirements & behavior · Requirements syntax

EARS

Give a textual requirement explicit context, trigger, and observable system response.

Introductory
Requirements & behavior · IETF convention

BCP 14 requirement levels

Distinguish mandatory requirements, recommendations, and genuine options.

Introductory
Requirements & behavior · Scenario language

Gherkin

Express a concrete behavior through starting conditions, an event, and an observable outcome.

Introductory
Requirements & behavior · Discovery practice

Example Mapping

Explore a feature by separating rules, concrete examples, unanswered questions, and scope.

Introductory
Requirements & behavior · Standard notation

BPMN

Describe a business process through activities, events, decisions, and participant boundaries.

Intermediate
Requirements & behavior · Standard notation

DMN & decision tables

Represent how input conditions produce an explicit decision outcome.

Intermediate
Contracts & knowledge · Specification

JSON Schema

Describe which JSON values have the structure and constraints your application expects.

Intermediate
Contracts & knowledge · Specification

OpenAPI

Describe an HTTP API’s operations, inputs, responses, and security requirements.

Intermediate
Contracts & knowledge · Specification

AsyncAPI

Describe message-driven interfaces through channels, operations, messages, and protocol details.

Intermediate
Contracts & knowledge · W3C vocabulary model

SKOS

Represent concepts, preferred terms, alternative labels, and their relationships consistently.

Intermediate
Contracts & knowledge · W3C constraint language

SHACL

Check RDF graph data against explicit shapes and constraints.

Advanced
Contracts & knowledge · Provenance model

W3C PROV

Describe the entities, activities, and agents involved in producing an artifact.

Intermediate
Precise behavioral models · Standard notation

Statecharts & SCXML

Describe which events can change a system’s state, including states where an action is no longer valid.

Intermediate
Precise behavioral models · Formal specification language

TLA+

Model possible system behaviors and state the properties those behaviors should satisfy.

Advanced
Precise behavioral models · Formal modeling language

Alloy

Explore structures and counterexamples described by relational constraints.

Advanced