OpenSite/Reference/Features/Shared settings - Revision history

BathAfrica: Link adjacent OpenSite reference pages in reading order

2026-10-29T21:15:52Z

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/Rectangular section example\|OpenSite/Reference/Features/Unit preferences\|OpenSite/Guides\|All guides}}</div>

BathAfrica: Publish organized OpenSite guides and reference navigation

2026-10-29T21:00:15Z

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=settings.shared		\|id=settings.shared
	\|summary=Read and change a named setting, and see which scope supplied the value.		\|summary=Read and change a named setting, and see which scope supplied the value.
Line 14:		Line 14:
	}}		}}


			== Try this workflow ==
			[[OpenSite/Guides/Set preferences\|Set preferences]] — 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 BathAfrica sidebar contents without duplicate inline contents box

2026-10-29T20:11:52Z

Use BathAfrica sidebar contents without duplicate inline contents box

← Older revision		Revision as of 13:11, 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:09Z

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=settings.shared
|summary=Read and change a named setting, and see which scope supplied the value.
|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=Setting numbers are not canonical engineering quantities. <code>units.profile</code> selects presentation only.
|behavior=Resolution order is session, document, workspace, user, then the application default. The CLI can read a setting, write a user value, reset it, and save <code>opensite-settings</code> version 1. A second save keeps the previous file as <code>path.bak</code>. Language, country, unit profile, and standards package are separate keys. Supported types are boolean, integer, real, and text. A preserved plugin value becomes active when a later schema accepts it. A token or credential key is rejected. That rejection does not make a value or an extension payload secret-proof.
|errors=Exit 1 for an unknown key, a rejected value, or a file that cannot be read. Exit 2 for arguments the command does not accept. A malformed file returns <code>corrupt_settings</code> and leaves memory unchanged. An unsupported format version returns <code>unsupported_version</code>.
|limitations=User preferences and permitted document overrides are exposed by the desktop Preferences/Document settings UI. A saved-workspace host remains pending. Lists, paths and structured setting values are not implemented as general preference pages. Workspace/document context ids do not open a workspace or document. Session values are not saved. One backup generation is kept; directory fsync is not claimed.
|hosts=Shared foundation settings service, CLI and embedded Python, plus desktop Edit → Preferences and permitted Edit → Document settings pages.
|licensing=Credential-like keys are rejected. That filter is not a secret store and not an entitlement check.
|verification=Repository evidence references (not rerun for this publication): CTest <code>foundation.settings</code> and <code>cli.preferences</code>. ADR-0021. Local Windows results are in <code>docs/verification/Phase-3-Acceptance.md</code>.
}}

== 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/settings.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]]