# shared/manifests/writing.short.manifest.ts > 206 lines of code and 1 definition. Tree: Governance tree Language: typescript Layer: infrastructure Canonical: https://banes-lab.com/anatomy/governance#file-governance-shared-manifests-writing-short-manifest-ts Source text: https://banes-lab.com/source/governance/shared/manifests/writing.short.manifest.ts.txt Listed in [shared/manifests](https://banes-lab.com/api/source/governance/shared/manifests.md), after [shared/manifests/writing.sentence.manifest.ts](https://banes-lab.com/source/governance/shared/manifests/writing.sentence.manifest.ts.md) and before [shared/manifests/writing.source.manifest.ts](https://banes-lab.com/source/governance/shared/manifests/writing.source.manifest.ts.md). ## Definitions - `SHORT_LAYER` (lexical_declaration, line 4, exported) ## Source ```typescript import type { CanonLayer } from "../../types/writing.types.ts"; import { LAYER_TITLES } from "../strings/writing.strings.ts"; export const SHORT_LAYER: CanonLayer = { covers: [ "taglines, subtitles, share-card lines and meta descriptions", "card descriptions and card list items", "labels, titles, captions and alt text", ], defersTo: [], id: "short", intro: "A short line has no surrounding sentence, so it carries its meaning alone.", rules: [ { bans: [ '"AI systems"', 'a bare "a model" in a tagline', "a full stop closing a phrase", "a slogan", "a card description written as a first-person sentence", "a subtitle that narrates the page's own tabs and what each one holds", ], checks: [], conditions: [ 'the short lines of a page say "LLMs", and its body copy then says "the model"', "a tagline slot keeps the developer's wording unless a finding names something in it", "a card description is one noun phrase that names what the card offers", ], examples: [ { rejected: "Structured instructions for AI systems.", repaired: null, why: "It names no party, closes a phrase with a full stop, and is a slogan.", }, { rejected: "I build a defined deliverable in your stack.", repaired: "A scoped build, modernization or refactor in your stack", why: "A card names the service it offers, and a first-person sentence on it reads as a pitch.", }, { rejected: "The anatomy page shows the source behind this site, parsed on every build. The reading tab explains what the page measures, and each tree tab holds one part of the codebase as it sits on disk, with every folder, file, syntax walk, definition and call edge.", repaired: null, why: "The developer rejected the subtitle, because it narrates the page's tabs in full sentences and names the page it sits on, where a subtitle is a short line.", }, ], gate: null, id: "short.tagline", rule: "A tagline may stay a phrase, and its words follow every rule a chapter follows.", why: "A line written for a card is still copy.", }, { bans: [ "the teaching voice on an offer page", "a first-person sentence where a card line names the offer", "a disclaimer or a hint that the page's controls already make plain", "a badge or a note that tells the client nothing they choose by", "an option the developer does not offer, added to fill out a choice", "a term whose condition rests on the developer's own schedule or circumstances", ], checks: [], conditions: [ "an offer page, such as a services or pricing page, is built from cards, lists, labels and controls, and each carries a short line", "the prose layer applies to teaching copy only, never to an offer page", "a term states its condition in what the client can see and plan around, such as the length of the engagement or the time of the request", ], examples: [ { rejected: "I review a codebase and its workflow, and I deliver a written report.", repaired: "A written review of your codebase and workflow", why: "The developer rejected the service page as written like the methodology page, because a card names the offer and teaches nothing.", }, { rejected: "A written review of your codebase and workflow", repaired: "A written review of your codebase architecture and governance", why: "The model added a workflow review, and the developer reviews code, not how a client works.", }, { rejected: "Agreed at kickoff", repaired: null, why: "Standards are set either by the developer or by the client, and the model padded the choice with a third option that does not exist.", }, { rejected: "Two-person team", repaired: null, why: "A team-size badge on a client card tells the client nothing they choose by.", }, { rejected: "Terms on the licensing page", repaired: null, why: "Each package ships with its license and terms inside, so the note tells the buyer nothing they choose by.", }, { rejected: "Built on the published methodology, architecture and PAG", repaired: null, why: "The note restates the site the client is already on, so it is noise under the cards.", }, { rejected: "35% on the rate, during my other commitments and rest hours", repaired: null, why: "The fee rests on the developer's private schedule, so the client cannot tell when it applies.", }, { rejected: "NACE 62.100", repaired: null, why: "A registry code in an engagement card header tells the client nothing they choose by, and the enterprise number in the footer already leads a client who checks registered activities to the registry.", }, ], gate: null, id: "short.offer", rule: "An offer page states each offer in the short lines of its cards and lists.", why: "A client scans an offer page to compare what is offered, and an explanation slows the scan.", }, { bans: [ "a label that restates the section above it", "a caption that describes the layout", "a qualifier appended to a label after a comma when the label reads alone", "a caption with no figure beside it where its neighbors each carry one", "a figure whose label does not name what it counts", "a unit repeated in the label of each figure that shares it", "an action label that names what the action carries instead of what it does", "a heading that names content its section does not hold", ], checks: [], conditions: [ "a label takes the form of its neighbors in the same file", "a figure is labeled by the fewest words that name what it counts", "an action label names the outcome the reader asks for", "the options of one choice are parallel noun phrases", "a choice option names its party, because a pronoun in a control is read from the reader's side", ], examples: [ { rejected: "Each block is a tab, and each node is a section you can open.", repaired: null, why: "It describes what the reader can already see.", }, { rejected: "Commits, all time", repaired: "Commits", why: "The appended qualifier adds noise, and the label reads alone.", }, { rejected: "215 peak 29 average per week", repaired: "Contributions per week: Peak 215, Average 29", why: "The figure names no unit, so the reader cannot tell what was counted.", }, { rejected: "Peak weekly contributions / Average weekly contributions", repaired: "Contributions per week: Peak 215, Average 29", why: "Both labels repeat the unit they share, where one caption names it once for both figures.", }, { rejected: "Contributions per week, last 52 weeks", repaired: "Contributions per week: Peak 215, Average 29", why: "The caption carried no figure while every other label on the card sits beside one.", }, { rejected: "Send This Estimate", repaired: "Request Service", why: "The button requests the service and fills the mail from the estimate, so the label named the contents instead of the act.", }, { rejected: "I set the standards / We agree standards first / Your standards apply as written", repaired: "Set by Bane's Lab / Set by your team", why: "The options were sentences in three different persons, where a choice names each option in the same form.", }, { rejected: "My standards / Agreed standards / Your standards", repaired: "Code and architecture standards: Set by Bane's Lab / Set by your team", why: "My and your swap meaning with the reader, and standards named no kind.", }, { rejected: "Request a Copy", repaired: "Buy", why: "The button starts a payment that issues the download, so the label named a request instead of the purchase.", }, { rejected: "Request an Assessment", repaired: "Request Service", why: "The label swapped in the engagement name, while the button requests the whole service the estimate describes.", }, { rejected: "Urgent Requests / Intervention: Immediate, requested by phone only", repaired: null, why: "The row label restates the heading above it, so the row names nothing new.", }, { rejected: "Up to 14 working days: paid on delivery", repaired: null, why: "The row does not say whose working days it counts, so the client cannot tell the terms follow the length of the engagement.", }, { rejected: "Contact Information", repaired: null, why: "The heading named contact details while the section held the working terms, and the footer already carries the contact details.", }, ], gate: null, id: "short.label", rule: "A label names the thing, and says nothing the page already shows.", why: "A caption that restates the UI is a truism.", }, ], title: LAYER_TITLES.short, }; ```