{
  "schema": "vedokrok.public-item.v1",
  "release_id": "MHC-RPUB-20260920-75ad787a",
  "url": "/knowledge/attach-the-source-next-to-the-claim-it-supports",
  "id": "MHC-D-RESEARCH-0611",
  "version": "0.1.0",
  "title": "Attach the source next to the claim it supports",
  "summary": "A source is most useful where the reader needs to verify the statement.",
  "kind": "principle",
  "body": "Place the relevant link, log, document section or screenshot beside the claim or action it supports. Add a short label describing what to inspect. This reduces hunting and makes unsupported statements visible.",
  "limits": [
    "Links can rot and permissions can fail; preserve required evidence according to the system's retention rules."
  ],
  "topics": [
    "union-actionable-async-writing"
  ],
  "intents": [],
  "source_ids": [
    "RS-B843492FBF1442AD",
    "RS-96557E8AD37744B8"
  ],
  "evidence": [
    {
      "claim": "CDC guidance recommends lists, chunks and descriptive headings to make information easier to scan and organize.",
      "source_id": "RS-B843492FBF1442AD",
      "role": "supports",
      "note": "Very short messages may not need headings; structure should match complexity.",
      "locator": "Core items 8 through 10"
    },
    {
      "claim": "ONS guidance recommends writing around user needs, removing content that does not serve those needs, and using concise task-focused headings.",
      "source_id": "RS-96557E8AD37744B8",
      "role": "supports",
      "note": "Regulated or audit-heavy work may require context that feels redundant to the immediate reader.",
      "locator": "Put users' needs first; titles and headings; be concise"
    }
  ],
  "use_when": [
    "A message ends with a pile of links and screenshots whose purpose is unclear."
  ],
  "avoid_when": [
    "Links can rot and permissions can fail; preserve required evidence according to the system's retention rules."
  ],
  "example": "Instead of 'logs attached,' write 'Activation completed at 10:42 — see SLG1 screenshot, row 3.'",
  "check": "A reviewer can move from an important claim to its evidence in one step.",
  "sources": [
    {
      "id": "RS-B843492FBF1442AD",
      "title": "Description and Examples of Index Items",
      "url": "https://www.cdc.gov/ccindex/tool/description-examples-parta.html"
    },
    {
      "id": "RS-96557E8AD37744B8",
      "title": "Writing and editing: Plain language",
      "url": "https://service-manual.ons.gov.uk/content/writing-for-users/plain-language"
    }
  ],
  "relations": [
    {
      "from": "MHC-D-RESEARCH-0611",
      "to": "MHC-D-RESEARCH-0613",
      "type": "useful_with",
      "url": "/knowledge/show-the-delta-when-a-requirement-changes"
    }
  ],
  "collections": [
    {
      "id": "RC-ECF674DEF65C9DAB",
      "title": "Write asynchronous messages that can be acted on without a meeting",
      "url": "/collections/write-asynchronous-messages-that-can-be-acted-on-without-a-meeting"
    }
  ]
}