BathAfrica:Documentation authoring

From BathAfrica Documentation
Revision as of 07:39, 29 October 2026 by BathAfrica (talk | contribs) (Update authoring guide after complete template import and image recovery)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This guide is for documentation authors across BathAfrica products.

Shared page templates

Use the optional review parameter to display a review notice. A historical “verified” label is not evidence that the current build was tested.

Inline formatting

  • Keyboard key: Ctrl
  • Button label: [Save]
  • Menu path: File → Save

See Template:BathAfrica Key, Template:BathAfrica Button, and Template:BathAfrica Menu for usage.

Existing SiteMasterDoc template migration

All 75 existing source templates and their 150 historical revisions have now been imported. Shared compatibility styles and extension fallbacks are installed. See BathAfrica:Template migration for the complete status and BathAfrica:Legacy template tests for the rendering gallery.

All 159 static dependency images have been recovered and preserved, including 155 recovered upstream because they were absent from SiteMasterDoc. Image binaries are not yet installed on this wiki: destination uploads are disabled and require secure server configuration first.

OpenSite source review

The uploaded Cursor documentation contains 27 article sources and four template authoring guides. Those guides were not executable rendering templates. The shared templates above implement their fields.

The article sources contain historical claims that need checking against the current repository and build, including GUI availability, expression support, file format version, console availability, and toolchain requirements. Do not publish those claims as current product instructions until checked. The 27 historical articles have not been published as current help.

Use product subpage titles such as OpenSite/Getting started and SiteMaster/Getting started. Keep verified functionality separate from planned features. Record the tested version and reproducible evidence when claiming verification.