Differences

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

--- dido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:01-04-03-using-the-wiki [2026/08/01 03:53] – created nick_dido
+++ dido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:01-04-03-using-the-wiki [2026/08/01 04:42] (current) – [Page Controls] nick_dido
@@ Line 5: / Line 5: @@
 The Crucible wiki supports both sequential reading and direct navigation. Readers can follow the numbered sections from the [[dido:02-crusible:00-toc:start|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 [[dido:99_annexes:annex-b-terms-and-definitions:e:evidence|Evidence]].
-The controls displayed along the right side of the screen provide access to page navigation, history, editing, and other wiki functions. The controls available to a user depend on the user's permissions.
+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 use the wiki controls and page links to:
+Readers can navigate the wiki through the page hierarchy, page Table of Contents, parent-page links, cross-references, and page controls.
-  * Open the Table of Contents
+==== Navigation Tree ====
-  * Navigate to parent and child pages
-  * Search for terms, requirements, architecture content, and implementation guidance
-  * Follow links to related pages and specific page sections
-  * Open the permanent URI for the current page
-  * Review pages that link to the current page
-  * View the revision history of the current page
-  * Compare earlier revisions
-  * Bookmark or share a direct reference to a page or section
-  * Return to the top-level Crucible page or the parent section
-Each page begins with a navigation link to its parent page. Section index pages provide a **Contents** area containing links to their child pages.
+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.
-Readers can also use the browser's address bar to copy the URI of the current page. When a page contains section anchors, readers can link directly to the relevant section rather than referencing the entire page.
+The highlighted entry identifies the page currently displayed.
+<WRAP centeralign>
+{{:dido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:crucible-navigation-tree.png?direct&200|Figure 1.4.3-1: Crucible navigation tree}}
+**Figure 1.4.3-1: Crucible navigation tree**
+</WRAP>
+The navigation tree allows readers to:
+  * Expand or collapse sections of the wiki
+  * Move between parent and child pages
+  * Identify the location of the current page within the publication
+  * Navigate 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.
+<WRAP centeralign>
+{{:dido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:page-table-of-contents.png?direct&150|Figure 1.4.3-2: Page Table of Contents}}
+**Figure 1.4.3-2: Page Table of Contents**
+</WRAP>
+The local Table of Contents differs from the publication-wide [[dido:02-crusible:00-toc:start|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.
+<WRAP centeralign>
+{{:dido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:reader-header-controls.png?direct&200|Figure 1.4.3-3: Reader page controls}}
+**Figure 1.4.3-3: Reader page controls**
+</WRAP>
+Depending on the installed plugins and the reader's permissions, these controls can provide access to functions such as:
+  * Sharing the current page
+  * Opening a feed
+  * Subscribing to page changes
+  * Printing the page
+  * Copying or opening a permanent page link
+A vertical toolbar can provide additional page functions.
+<WRAP centeralign>
+{{:dido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:reader-toolbar.png?direct&50|Figure 1.4.3-4: Reader toolbar}}
+**Figure 1.4.3-4: Reader toolbar**
+</WRAP>
+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.
+<WRAP centeralign>
+{{:dido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:trace-display.png?direct&700|Figure 1.4.3-5: Trace display}}
+**Figure 1.4.3-5: Trace display**
+</WRAP>
+Backlinks identify pages that contain a link to the current page. Backlinks support [[dido:99_annexes:annex-b-terms-and-definitions:t:traceability|Traceability]] by allowing readers to identify where a requirement, controlled term, architecture element, or other subject is referenced.
 ===== For Editors =====
-Authorized editors can use the additional wiki controls to:
+Authorized editors receive additional controls for creating and maintaining wiki content.
+<WRAP centeralign>
+{{:dido:02-crusible:01-introduction:01-04-how-to-use-this-wiki:editor-toolbar.png?direct&50|Figure 1.4.3-6: Editor toolbar}}
+**Figure 1.4.3-6: Editor toolbar**
+</WRAP>
+Depending on the editor's permissions, the toolbar can provide access to functions such as:
+  * Editing the current page
+  * Reviewing the page history
+  * Viewing backlinks
+  * Creating a page
+  * Deleting a page
+  * Exporting the page
+  * Moving or renaming a page
+  * Returning to the top of the page
+Editors can also:
-  * Edit the complete page
   * Edit an individual section
-  * Create a new page
   * Preview changes before saving
   * Provide an edit summary
-  * Review and compare revisions
+  * Compare revisions
   * Restore an earlier revision when authorized
-  * Rename or move a page when authorized
   * Add links to controlled terms, requirements, and related content
   * Include canonical content from another page through transclusion
@@ Line 74: / Line 146: @@
 </code>
-This approach preserves [[dido:99_annexes:annex-b-terms-and-definitions:t:traceability|Traceability]] and ensures that readers see the maintained requirement Statement wherever it is referenced.
+This approach preserves Traceability and ensures that readers see the maintained requirement Statement wherever it is referenced.
 ----