OpenSite/Reference/Features/Unit preferences - Revision history

BathAfrica: Link adjacent OpenSite reference pages in reading order

2026-10-29T21:15:55Z

Link adjacent OpenSite reference pages in reading order

← Older revision		Revision as of 14:15, 29 October 2026
Line 28:		Line 28:
	[[Category:OpenSite documentation]]		[[Category:OpenSite documentation]]

	<div class="os-page-nav">{{Docnav\|OpenSite/~~Getting started~~\|OpenSite/~~Guides~~\|OpenSite/Guides\|All guides}}</div>		<div class="os-page-nav">{{Docnav\|OpenSite/Reference/Features/Shared settings\|OpenSite/Reference/Features\|OpenSite/Guides\|All guides}}</div>

BathAfrica: Publish organized OpenSite guides and reference navigation

2026-10-29T21:00:18Z

Publish organized OpenSite guides and reference navigation

← Older revision		Revision as of 14:00, 29 October 2026
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
			{{OpenSite scope}}
	{{BathAfrica Feature		{{BathAfrica Feature
	\|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.
	\|id=foundation.unit-preferences		\|id=foundation.unit-preferences
	\|summary=Select how quantities are presented without changing the stored values.		\|summary=Select how quantities are presented without changing the stored values.
Line 14:		Line 14:
	}}		}}


			== Try this workflow ==
			[[OpenSite/Guides/Quantities and profiles\|Quantities and profiles]] — a worked lesson with expected results.

	== Documentation basis ==		== Documentation basis ==
Line 24:		Line 27:
	[[OpenSite\|OpenSite overview]] · [[OpenSite/Reference\|Reference]] · [[OpenSite/Guides\|Guides]]		[[OpenSite\|OpenSite overview]] · [[OpenSite/Reference\|Reference]] · [[OpenSite/Guides\|Guides]]
	[[Category:OpenSite documentation]]		[[Category:OpenSite documentation]]

			<div class="os-page-nav">{{Docnav\|OpenSite/Getting started\|OpenSite/Guides\|OpenSite/Guides\|All guides}}</div>

BathAfrica: Use sidebar contents consistently on unit-preferences reference

2026-10-29T20:15:18Z

Use sidebar contents consistently on unit-preferences reference

← Older revision		Revision as of 13:15, 29 October 2026
Line 1:		Line 1:
			__NOTOC__
	{{BathAfrica Feature		{{BathAfrica Feature
	\|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.		\|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.

BathAfrica: Publish Cursor documentation reconciled with OpenSite source 77c3fee; tests not rerun

2026-10-29T20:08:39Z

Publish Cursor documentation reconciled with OpenSite source 77c3fee; tests not rerun

New page

{{BathAfrica Feature
|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.
|id=foundation.unit-preferences
|summary=Select how quantities are presented without changing the stored values.
|status=Implemented in the reviewed development source. Historical test evidence is recorded by the repository; no test rerun or product release is claimed by this publication.
|units=The service stores profile ids and unit ids. It does not store an SI value.
|behavior=The application default profile is SI. The user can select <code>engineering_metric</code> or <code>us_customary</code>. A document key and a property can override the presentation. The default object owns a private settings service. <code>UnitPreferences(SettingsService&)</code> uses a caller-owned service, and that service is the only preferences file. Save writes <code>opensite-settings</code> version 1. Load still accepts <code>opensite-unit-preferences</code> version 1 and migrates it. A change to <code>units.profile</code> through the shared service updates this object and notifies its listeners. Listeners are notified after a real change.
|errors=<code>corrupt_preferences</code>, <code>unsupported_version</code>, <code>reentrant_call</code>, and <code>incompatible_dimension</code> when a display unit does not match the quantity.
|limitations=The desktop Preferences window and document/property presentation consume this service. Scope and property overrides affect formatting, not canonical SI values. Language/country remain separate settings. Do not treat a preference file as an engineering document or as a design-code unit system.
|hosts=C++ service, CLI, embedded Python and Windows desktop preferences/quantity presentation. The core service does not depend on Qt.
|licensing=A profile change is presentation. It does not check a design code and it does not change a stored SI value.
|verification=Repository evidence references (not rerun for this publication): CTest <code>foundation.unit_preferences</code>. ADR-0016. The seven CI jobs for commit <code>34d462a9ac58634ed66604a4df829fc5a7a7730e</code> are in the Phase 1 acceptance report.
}}

== Documentation basis ==
Source-reviewed against development commit <code>77c3fee13944bcc4b5d487c77eb1f82fbe4c6ea7</code>, branch <code>feature/phase-13c-properties-python-expressions</code>. This review inspected the implementation and repository evidence; it did not run the Windows application or repeat CTest.

* <code>src/foundation/unit_preferences.cpp</code>
* <code>src/gui/preferences_window.cpp</code>
* <code>docs/verification/Phase-11P-Preferences.md</code>

[[OpenSite|OpenSite overview]] · [[OpenSite/Reference|Reference]] · [[OpenSite/Guides|Guides]]
[[Category:OpenSite documentation]]