Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
29 changes: 29 additions & 0 deletions docs/reports/installed-windows-2026-11-11.md
Original file line number Diff line number Diff line change
@@ -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.
Binary file not shown.
70 changes: 70 additions & 0 deletions docs/reports/windows-application-guide-1.1.0.json
Original file line number Diff line number Diff line change
@@ -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"
}
}
Loading