1.4.3 Using the Wiki

Go to 1.4 About the Wiki

The Crucible wiki supports both sequential reading and direct navigation. Readers can follow the numbered sections from the Table of Contents, move through parent and child pages, search for a subject, or follow links among related concepts, requirements, architecture content, implementation guidance, and Evidence.

The controls displayed around the page provide access to navigation, page history, backlinks, permanent links, document export, editing, and other wiki functions. The controls available to a user depend on the user's permissions.

For Readers

Readers can navigate the wiki through the page hierarchy, page Table of Contents, parent-page links, cross-references, and page controls.

Navigation Tree

The navigation tree displays the wiki hierarchy. Folder icons identify namespaces that contain child pages. Page icons identify individual wiki pages. The plus and minus controls expand or collapse parts of the hierarchy.

The highlighted entry identifies the page currently displayed.

Figure 1.4.3-1: Crucible navigation tree

Figure 1.4.3-1: Crucible navigation tree

The navigation tree allows readers to:

Expand or collapse sections of the wikiMove between parent and child pagesIdentify the location of the current page within the publicationNavigate directly to another section without returning to the main Table of Contents

Page Table of Contents

A page containing multiple headings displays a local Table of Contents. The local Table of Contents links directly to the headings within the current page.

Figure 1.4.3-2: Page Table of Contents

Figure 1.4.3-2: Page Table of Contents

The local Table of Contents differs from the publication-wide Table of Contents. The publication-wide Table of Contents identifies pages throughout the Crucible wiki, while the local Table of Contents identifies sections within the current page.

Page Controls

Reader controls appear near the page or along the right side of the screen.

Figure 1.4.3-3: Reader page controls

Figure 1.4.3-3: Reader page controls

Depending on the installed plugins and the reader's permissions, these controls can provide access to functions such as:

Sharing the current pageOpening a feedSubscribing to page changesPrinting the pageCopying or opening a permanent page linkA vertical toolbar can provide additional page functions.

Figure 1.4.3-4: Reader toolbar

Figure 1.4.3-4: Reader toolbar

The exact controls displayed depend on the page, installed plugins, and permissions assigned to the reader.

Trace and Backlinks

The Trace display identifies recently visited pages and provides direct access to those pages.

Figure 1.4.3-5: Trace display

Figure 1.4.3-5: Trace display

Backlinks identify pages that contain a link to the current page. Backlinks support Traceability by allowing readers to identify where a requirement, controlled term, architecture element, or other subject is referenced.

For Editors

Authorized editors receive additional controls for creating and maintaining wiki content.

Figure 1.4.3-6: Editor toolbar

Figure 1.4.3-6: Editor toolbar

Depending on the editor's permissions, the toolbar can provide access to functions such as:

Editing the current pageReviewing the page historyViewing backlinksCreating a pageDeleting a pageExporting the pageMoving or renaming a pageReturning to the top of the pageEditors can also:

Edit an individual sectionPreview changes before savingProvide an edit summaryCompare revisionsRestore an earlier revision when authorizedAdd links to controlled terms, requirements, and related contentInclude canonical content from another page through transclusionMaintain parent and child navigationRecord unresolved matters in the applicable Issues sectionFollow the established namespace, heading, page-structure, and copyright conventionsEditors should link to canonical content rather than reproduce independently maintained copies. When content must appear in more than one operational context, editors should use a link or transclusion whenever practical.

Editors should preserve stable page namespaces after other pages or external artifacts begin referencing them. A displayed page title can change without changing its namespace when retaining the existing URI avoids broken links.

Page and Section Links

A link to a wiki page uses the page's namespace:

[[dido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:01-04-01-why-a-wiki|1.4.1 Why a Wiki]]

A link can also reference a specific section within a page:

[[dido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:01-04-01-why-a-wiki#Traceability|Traceability]]

Section index pages use a trailing start page. Individual leaf pages omit a trailing start from their namespaces.

Canonical Content

The wiki maintains controlled terms, requirements, and other authoritative content on canonical pages. Other pages should link to or transclude that content rather than create independent copies.

For example, a page can display the current Statement from a canonical requirement page by using:

{{section>REQUIREMENT_NAMESPACE#Statement&noheader&nofooter&noeditbtn}}

This approach preserves Traceability and ensures that readers see the maintained requirement Statement wherever it is referenced.

© 2026 Dido Solutions, Inc. and Jackrabbit Consulting, Inc.