Note
- How
- A smaller paragraph in the muted ink, under the block it qualifies.
- When
- When something about the work needs a caveat: it is proprietary, the file is password protected, a decision is still open. Not for emphasis, and not for anything the reader needs in order to follow the page.
- Where
- After the paragraphs inside a block, or after a button
row. In a hero it comes from
CaseHero’snoteprop instead.
In code
Section titled “In code”src/components/ui/Note.astro.
---import Note from '../../components/ui/Note.astro';---<Note>Password protected. Ask me and I will send it.</Note>No props. In a hero, pass the text as CaseHero’s note prop rather than
rendering this directly.
It is not a warning
Section titled “It is not a warning”It carries no role, no icon and no colour other than the muted ink, so a
screen reader reads it in the flow of the page like any other paragraph. That is
deliberate. A caveat on a portfolio page is information, not an alert, and
dressing it as an alert makes the page look like it is apologising.
What goes in one
Section titled “What goes in one”The honest limits of what is being shown. The PayPal pages use it to say the work is proprietary and the flows are generic. The Meatingplace sections use it to say the Figma file is password protected. The Artistic Eye page uses it to say the pink is still undecided.
A note that hides an unresolved fact defeats the point. If a colour is not settled, the note says so.
Do
- Say plainly what is not being shown, and why.
- Name a decision that is still open.
- Keep it to one or two sentences.
Don’t
- Use it for emphasis or for a pull quote.
- Put information the reader needs in it.
- Give it a role, an icon or an alert colour.
Checks before you ship
Section titled “Checks before you ship”- The page still reads correctly if the note is skipped.
- It states a limit or a caveat, not a selling point.
- It is one or two sentences.
- Nothing in it is dressed up as an alert.