Docs-as-code snippet

Docs · Example

Summary: New pages drift without a spine. This starter matches Product law: Title + Summary, then stepped body — no chip soup.

Step 1 — Name the drift

Portfolio notes drift: some pages are essays, some are bullet piles, lab vs work gets blurry. Hiring screens should skim; reviewers should trust the lab mark.

Step 2 — Pick the spine

Open with Title + Summary / purpose only. Then TOC → numbered steps → Outcome / Clone. Keep authoring fields (stack, label, screenshots) out of the top of the page — end note is fine if needed. Full rules live on the Docs standard.

Step 3 — Copy the starter

Template (markdown):

# Example lab note

Summary: What changed in one line.

## On this page
1. Step 1 — …
2. Step 2 — …

## Step 1 — …
…

## Step 2 — …
…

## Outcome
…

## Clone
```bash
git clone https://www.portfolio.btcbrewery.com/git/git-hooks-examples.git
```

Step 4 — Ship and check

  • Before: Ad-hoc sections; clone URLs and lab labels easy to forget; chip soup at the top.
  • After: Quiet open; stepped body; ban list scrubbed; lab mark honest in prose or an end note.

Outcome

Copy-paste starter for lab or transferable write-ups. Publish as WP HTML or keep markdown in the operator docs tree.

Transferable · Markdown / WordPress HTML