dido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:01-04-01-why-a-wiki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
dido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:01-04-01-why-a-wiki [2026/08/01 03:43] – nick_didodido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:01-04-01-why-a-wiki [2026/08/01 03:45] (current) – nick_dido
Line 7: Line 7:
 A traditional linear document requires a reader to open the complete document, locate the appropriate chapter, and search within that chapter for the relevant subject. As the document grows, this process becomes slower and makes precise references more difficult. A traditional linear document requires a reader to open the complete document, locate the appropriate chapter, and search within that chapter for the relevant subject. As the document grows, this process becomes slower and makes precise references more difficult.
  
-The wiki assigns a distinct page and URI to each major subject. A reader can therefore access, bookmark, or reference the specific page needed without opening and searching a long document. Pages can also link to specific sections within another page.+The wiki assigns a distinct page and URI to each major subject. A reader can therefore access, bookmark, or reference the specific page needed without opening and searching a long document. Pages can also link directly to specific sections within another page.
  
 This structure allows requirements, architecture pages, issues, review comments, emails, and external documents to reference precise content rather than an entire publication. This structure allows requirements, architecture pages, issues, review comments, emails, and external documents to reference precise content rather than an entire publication.
  
 The wiki also supports canonical content. A controlled term, requirement, or other authoritative subject can reside on one maintained page and be linked or transcluded wherever the content applies. This reduces duplication and prevents independently maintained copies from becoming inconsistent. The wiki also supports canonical content. A controlled term, requirement, or other authoritative subject can reside on one maintained page and be linked or transcluded wherever the content applies. This reduces duplication and prevents independently maintained copies from becoming inconsistent.
 +
 +The wiki strengthens [[dido:99_annexes:annex-b-terms-and-definitions:t:traceability|Traceability]] by allowing pages to link directly to the requirements, controlled terms, architecture elements, operational scenarios, verification criteria, implementation records, and [[dido:99_annexes:annex-b-terms-and-definitions:e:evidence|Evidence]] that support or depend on their content.
 +
 +These links allow readers to follow relationships in both directions. A requirement can identify its source, rationale, verification criteria, related operational content, and implementation status, while backlinks can identify the pages that reference the requirement. This makes the relationships among intent, requirements, architecture, implementation, verification, and Evidence visible and navigable.
  
 The wiki supports: The wiki supports:
Line 17: Line 21:
   * Direct access to individual subjects through page and section URIs   * Direct access to individual subjects through page and section URIs
   * Precise references from requirements, architecture pages, issues, reviews, emails, and external documents   * Precise references from requirements, architecture pages, issues, reviews, emails, and external documents
 +  * Traceability among operational concepts, requirements, architecture, implementation, verification, and Evidence
 +  * Backlinks that identify pages referring to a subject
   * Role-specific navigation for executives, engineers, operators, auditors, and other stakeholders   * Role-specific navigation for executives, engineers, operators, auditors, and other stakeholders
   * Stable links to controlled terms, requirements, operational concepts, and implementation guidance   * Stable links to controlled terms, requirements, operational concepts, and implementation guidance
   * Reuse of canonical content without maintaining duplicate copies   * Reuse of canonical content without maintaining duplicate copies
-  * Backlinks that identify pages referring to a subject 
   * Independent review and maintenance of pages that change at different rates   * Independent review and maintenance of pages that change at different rates
   * Expansion of the publication without requiring every reader to navigate an increasingly long linear document   * Expansion of the publication without requiring every reader to navigate an increasingly long linear document
  • dido/02-crusible/01-introduction/01-04-how-to-use-this-wiki/01-04-01-why-a-wiki.1785580991.txt.gz
  • Last modified: 2026/08/01 03:43
  • by nick_dido