{"id":"CLR-018","name":"Test instructions by execution","domain":"clarity","layer":"section","strength":"hard_constraint","human_logic":"IF content instructs a real task, THEN have a representative reader or test environment execute it and record failures ELSE review semantically.","when":{"path":"section.topic_type","operator":"eq","value":"task"},"then":[{"action":"test","target":"section","method":"representative_execution"},{"action":"record","target":"section.test_failures"},{"action":"revise","target":"section","from":"observed_failures"}],"else":[{"action":"retain","target":"current_text","reason":"No triggering condition is present."}],"unless":[],"because":"An instruction is usable only if it produces the intended result in practice.","diagnostics":[],"examples":{},"source_ids":["WEB-002","WEB-008","BK-021","BK-024"],"laka":{"smallest_sufficient_intervention":true,"primary_axes":["scope","depth","magnitude","reversibility"]},"requires_facts":["section.topic_type"],"tests":[],"sources":[{"id":"WEB-002","title":"Principles of plain language","creator":"Digital.gov / U.S. General Services Administration","domain":"plain_language","type":"Government guidance","note":"Design content so the intended audience can find, understand, and use it.","url":"https://www.plainlanguage.gov/"},{"id":"WEB-008","title":"DITA 1.3 Technical Content Specification","creator":"OASIS","domain":"structured_authoring","type":"OASIS Standard","note":"Topic-based concept, task, reference, troubleshooting, and reuse architecture.","url":"https://docs.oasis-open.org/dita/dita/v1.3/os/part2-tech-content/dita-v1.3-os-part2-tech-content.html"},{"id":"BK-021","title":"Technical Writing Process","creator":"Kieran Morgan","domain":"technical_writing","type":"Book","note":"A repeatable process for planning and producing documentation.","url":null},{"id":"BK-024","title":"Developing Quality Technical Information","creator":"Michelle Carey; Moira Lanyi; Deirdre Longo; et al.","domain":"technical_writing","type":"Book","note":"Quality dimensions for usable technical information.","url":null}],"defined_in":{"file":"11-clarity-style-rules.json","title":"Clarity, Precision, and Plain-Language Rules","slug":"clarity-style-rules"}}