diff --git a/README.md b/README.md index 8cdaa63..56680ef 100644 --- a/README.md +++ b/README.md @@ -176,8 +176,19 @@ unverified compilers/platforms. See [docs/operations.md](docs/operations.md). ## License [MIT](LICENSE) + ## Documentation editions Start with the [organized handbook](docs/handbook.md) for current usage, design, security and test guidance. Reviewed downloadable editions: [project-guide.docx](docs/reports/project-guide.docx). [Publication identities and source scope](docs/reports/publications.json) · [Documentation validation record](docs/reports/documentation-refresh-2026-11-09.md). Historical results retain their own tested revision and date. + +## Current Windows application guide + +The published **1.1.0** app has a [four-page illustrated guide](docs/reports/windows-application-guide-1.1.0.docx) with actual installed screenshots, a worked user journey, important source excerpts and operating limits. Read the [dated validation report](docs/reports/installed-windows-2026-11-11.md) and [byte/page review manifest](docs/reports/windows-application-guide-1.1.0.json) for exact scope. Historical documentation editions remain unchanged. + +Added files: + +- [docs/reports/windows-application-guide-1.1.0.docx](docs/reports/windows-application-guide-1.1.0.docx): source-specific installed-app workflow, screenshots, code and measured validation. +- [docs/reports/windows-application-guide-1.1.0.json](docs/reports/windows-application-guide-1.1.0.json): document, screenshot, immutable-source and reviewed-page hashes. +- [docs/reports/installed-windows-2026-11-11.md](docs/reports/installed-windows-2026-11-11.md): observed results, installation, data handling and remaining limits. diff --git a/docs/reports/installed-windows-2026-11-11.md b/docs/reports/installed-windows-2026-11-11.md new file mode 100644 index 0000000..6a820f6 --- /dev/null +++ b/docs/reports/installed-windows-2026-11-11.md @@ -0,0 +1,29 @@ +# Installed Windows application validation · 11 November 2026 + +By Jason Stys. This report records actual published **1.1.0** installed bytes from `4ba77538f5d3025677c51dc3948c1870d2aff963`. Earlier Office editions retain their historical baselines and bytes. + +## Observed results + +The installed three-phase consumer verified actual play/timer inputs, replay/export, exact authored-scene restart and preserved corrupt-profile recovery. + +All required main workflows for the runtime revision passed; processed CodeQL analyses reported zero open main alerts before release. + +All 2 assets matched provider/checksum identities; all 6 installed files remained unchanged during acceptance. + +New per-user version folder and individual links verified. Synthetic profiles only; existing data and Docker were not used or changed. + +## Illustrated user workflow and implementation + +The [four-page guide](windows-application-guide-1.1.0.docx) contains two actual installed-application screenshots, a worked user journey, important immutable-source code excerpts, validation observations and practical limits. Every final page content was individually inspected and the OOXML schema passed. The [review manifest](windows-application-guide-1.1.0.json) binds the Word, screenshot, source and rendered-page identities. Prepared examples are inputs to the full application, never separate demo apps. + +## Installation, data and limits + +Keep the complete extracted ZIP together and launch Forge2DEditor.exe. No system runtime or terminal setup is needed. + +Open the verified Desktop icon. Help describes supported inputs and workflow limits; close through the app's owner controls and back up its external data directory after a normal exit. + +Unsigned Windows portable app; not an OS installer, signing proof or clean-machine certification. Only marked synthetic profiles and actual own-window handlers/timers tested; no normal AppData, populated-user upgrade or external OS input automation. + +Prepared inputs and acceptance used synthetic data only; normal profiles were not opened and Docker was unchanged. Local plaintext is trusted-OS-owner data, not protection against that OS user or administrator. + +Desktop and Start-menu link targets were verified. The full installed-executable acceptance is distinct from normal shortcut activation; no additional manual shortcut-button test is claimed. Existing accounts and Docker were unchanged. This documentation revision must pass its own complete hosted checks; earlier runtime results do not certify future source changes. diff --git a/docs/reports/windows-application-guide-1.1.0.docx b/docs/reports/windows-application-guide-1.1.0.docx new file mode 100644 index 0000000..01645ea Binary files /dev/null and b/docs/reports/windows-application-guide-1.1.0.docx differ diff --git a/docs/reports/windows-application-guide-1.1.0.json b/docs/reports/windows-application-guide-1.1.0.json new file mode 100644 index 0000000..6e7dc6f --- /dev/null +++ b/docs/reports/windows-application-guide-1.1.0.json @@ -0,0 +1,70 @@ +{ + "schema": 1, + "repository": "forge2d-engine", + "runtimeVersion": "1.1.0", + "runtimeSource": "4ba77538f5d3025677c51dc3948c1870d2aff963", + "createdAt": "2026-11-11T06:23:42.248Z", + "author": "Jason Stys", + "document": "windows-application-guide-1.1.0.docx", + "sha256": "0fe5340cf4c7190b34fff22b9d5733bb3fb89bb6d6d99654847c72b5b97693fb", + "screenshots": [ + { + "file": "editor-layers.png", + "sha256": "6bcb6a818de2679d52489a664afef75d769749281414f775d437f4572cbcf7e8", + "width": 1240, + "height": 850, + "caption": "The installed editor applies the selected collision categories and masks to the authored scene. Overlap reporting is distinct from physical collision response." + }, + { + "file": "editor-play.png", + "sha256": "664ae3e88cecbf0fb7f812472784134c1d551812e89d19953c333865d95bbee3", + "width": 1240, + "height": 850, + "caption": "The same editor displays the actual engine scene and input replay, with the current tick, authored source and recording visible." + } + ], + "snippets": [ + { + "file": "src/editor.cpp", + "first": 18, + "last": 35, + "sha256": "0a3ba9336ccce75dc424cef977bea511d4d33e3f7ae91fddfe93b8e0237a4bd0", + "url": "https://github.com/JasonStys/forge2d-engine/blob/4ba77538f5d3025677c51dc3948c1870d2aff963/src/editor.cpp#L18" + } + ], + "observedTests": [ + { + "name": "Real native workflows", + "observed": "The installed three-phase consumer verified actual play/timer inputs, replay/export, exact authored-scene restart and preserved corrupt-profile recovery.", + "result": "Passed" + }, + { + "name": "Source and security", + "observed": "All required main workflows for the runtime revision passed; processed CodeQL analyses reported zero open main alerts before release.", + "result": "Passed" + }, + { + "name": "Distribution identity", + "observed": "All 2 assets matched provider/checksum identities; all 6 installed files remained unchanged during acceptance.", + "result": "Verified" + }, + { + "name": "PC scope", + "observed": "New per-user version folder and individual links verified. Synthetic profiles only; existing data and Docker were not used or changed.", + "result": "Verified" + } + ], + "visualReview": { + "approved": true, + "reviewer": "root", + "ooxmlSchema": "passed", + "pages": { + "page-1.png": "8f4fb8c1f26de781719e802fea0b1804a48a9ae7944c37ea0aa8d82492813c46", + "page-2.png": "53b9ea35cbbebb145a20c6ba59b39625b1b09a2a50b56a35f888465b9b8d00ce", + "page-3.png": "560ca7bf905edea1388c94ea3cd01c890aba9499b05eedc8703ba35e16397234", + "page-4.png": "9f4cf82fdd6fa4d64350bc9bdb256b050cd62f007372a1720ede411c727771ed" + }, + "scope": "All four final page contents individually inspected; only exact identical pixels carry prior inspection.", + "checkedUtc": "2026-11-11T07:15:07.512506+00:00" + } +}