Skip to content
All resources

Annotated primary-source reading paths

Choose a reading path with original annotations and a concrete exercise after each source.

Downloads

Read toward a task rather than collecting an unstructured list of links. Each path pairs primary material with an exercise you can do on your own content. The sources remain on their publishers' sites; this library is not a mirror.

Write one useful procedure

Start with GitHub's article model. Look for the relationship between introduction, prerequisites and next steps. Try: rewrite one guide's opening as an outcome, then move every requirement before the step that needs it.

Compare Cloudflare's quickstart source. Notice where optional explanation leaves the main path. Try: read your guide using only the actions; repair any missing dependency.

Use Supabase's page-structure guide to separate task, concept and reference. Try: move a long conceptual detour into its own explanation and link it where needed. The point is reader focus, not copying a foreign house style.

Keep richer content maintainable

Read Stripe's Markdoc explanation for the distinction between declarative content and arbitrary page logic. Try: list what a proposed interactive component must accept and what useful text remains if it is absent. A new framework is not required to benefit from a smaller component vocabulary.

Read Vercel's Markdown access guidance. Try: compare one HTML article with its plain-text alternate, including code, warnings and links. An alternate representation is useful only when it retains the selected content.

Review a research handoff

Use the CommonMark reference for ordinary Markdown structure and OWASP's prompt-injection guidance for the boundary between external text and instructions. Try: create an attributed note with a short excerpt and your own interpretation. Keep source instructions out of the authority to act.

This source-block template helps you record your own method. Replace the prompts before using it as a finished attribution:

## Sources and method

- Primary source: [CommonMark reference](https://commonmark.org/help/).
- Method: source-based synthesis with an original worked example.
- What we checked: list the source passages and any executed example.
- Limits: identify what was not tested.

This article shares what we learned; it is not the source publisher’s official documentation.

Link to originals and respect their terms. Attribution alone does not authorize copying a full source or its assets.