Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
| dido:02-crusible:99-annexes:annex-b:start [2026/07/15 09:33] – nick_dido | dido:02-crusible:99-annexes:annex-b:start [2026/07/20 07:07] (current) – ↷ Links adapted because of a move operation nick_dido | ||
|---|---|---|---|
| Line 9: | Line 9: | ||
| Crucible-specific references use identifiers in the form: | Crucible-specific references use identifiers in the form: | ||
| - | * [CR1] | + | * [C1] |
| - | * [CR2] | + | * [C2] |
| - | * [CR3] | + | * [C3] |
| The corresponding namespaces use only the stable numeric identifier rather than the document title. | The corresponding namespaces use only the stable numeric identifier rather than the document title. | ||
| Line 20: | Line 20: | ||
| * '' | * '' | ||
| - | The descriptive document title appears in the page heading and link text rather than in the namespace. | + | The descriptive document title appears in the reference-page heading and in the References list. |
| ===== References ===== | ===== References ===== | ||
| - | * [[dido: | + | * [[dido: |
| - | * [[dido: | + | * [[dido: |
| - | + | ||
| - | ===== Reference Page Content ===== | + | |
| - | + | ||
| - | Each reference page may identify: | + | |
| - | + | ||
| - | * Reference identifier | + | |
| - | * Document title | + | |
| - | * Author or issuing organization | + | |
| - | * Version | + | |
| - | * Revision | + | |
| - | * Publication date | + | |
| - | * Document status | + | |
| - | * Citation | + | |
| - | * Description | + | |
| - | * Source location | + | |
| - | * Related Crucible pages | + | |
| - | * Supersession information | + | |
| ===== Citation Use ===== | ===== Citation Use ===== | ||
| - | Crucible pages should | + | Crucible pages cite a reference by linking |
| For example: | For example: | ||
| <code dokuwiki> | <code dokuwiki> | ||
| - | [[dido: | + | [[dido: |
| </ | </ | ||
| - | A requirement | + | A requirement |
| <code dokuwiki> | <code dokuwiki> | ||
| ===== Source ===== | ===== Source ===== | ||
| - | [[dido: | + | [[dido: |
| </ | </ | ||
| Line 71: | Line 54: | ||
| Maintain each reference as a separate linked wiki page with a stable URI. | Maintain each reference as a separate linked wiki page with a stable URI. | ||
| - | Assign each new Crucible-specific reference the next available identifier in the sequence [CR1], [CR2], [CR3], and so forth. | + | Assign each new Crucible-specific reference the next available identifier in the sequence [C1], [C2], [C3], and so forth. |
| Use namespaces in the form: | Use namespaces in the form: | ||
| Line 80: | Line 63: | ||
| Do not include the document title in the namespace. | Do not include the document title in the namespace. | ||
| + | |||
| + | Use page headings in the form: | ||
| + | |||
| + | <code dokuwiki> | ||
| + | ====== C1 - Document Title ====== | ||
| + | </ | ||
| Use the reference page as the canonical citation target rather than repeating the complete citation throughout the Crucible documentation. | Use the reference page as the canonical citation target rather than repeating the complete citation throughout the Crucible documentation. | ||