docs: add OKF_Nuxt decision records and log
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Typecheck (pull_request) Successful in 38s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
PR Check / Dependency audit (pull_request) Failing after 8s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 5s
PR Check / AI code review (opencode) (pull_request) Canceled after 16s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Typecheck (pull_request) Successful in 38s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
PR Check / Dependency audit (pull_request) Failing after 8s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 5s
PR Check / AI code review (opencode) (pull_request) Canceled after 16s
This commit is contained in:
1 parent
9987d6b8e4
commit
bb0ab03a97
9 files changed
+390
No files matched your search
@@ -0,0 +1,55 @@
|
||||
---
|
||||
type: Decision
|
||||
title: Mockup layout
|
||||
description: Every mockup screen folder holds DESIGN.md, code.html and screen.png, with the screenshot and the full source embedded in the markdown.
|
||||
tags: [decision, design, mockups]
|
||||
status: stable
|
||||
generated: { by: opencode/deepseek-v4.1-flash, at: 2026-10-18T12:41:52Z }
|
||||
verified: { by: human:noel, at: 2026-10-18T12:41:52Z }
|
||||
sources:
|
||||
- id: stitch-export
|
||||
resource: Stitch export "resilient_systems_engineer_portfolio", seven screens
|
||||
title: Stitch export used for the mockups
|
||||
---
|
||||
|
||||
# Decision
|
||||
|
||||
Each screen is one folder holding three files, all at the same level:
|
||||
|
||||
| File | Role |
|
||||
|---|---|
|
||||
| `DESIGN.md` | The screen as a document: frontmatter, the screenshot rendered inline, then the full source in a fenced block. |
|
||||
| `code.html` | The screen's source, unchanged. |
|
||||
| `screen.png` | The rendered screenshot, kept separately so it can be opened directly. |
|
||||
|
||||
The export's folder names were replaced with short, consistent ones:
|
||||
|
||||
| Export name | Folder |
|
||||
|---|---|
|
||||
| `noel_sabia_homepage_cv_overview` | `homepage` |
|
||||
| `noel_sabia_overview_mobile` | `homepage_mobile` |
|
||||
| `noel_sabia_dev_view_technical_telemetry` | `dev_view` |
|
||||
| `noel_sabia_dev_view_mobile` | `dev_view_mobile` |
|
||||
| `noel_sabia_life_map` | `life_map` |
|
||||
| `noel_sabia_life_map_mobile` | `life_map_mobile` |
|
||||
| `noel_sabia_infrastructure_ai_resilience` | `design_system` |
|
||||
|
||||
# Why
|
||||
|
||||
A screen should be readable as one document without opening anything else, which
|
||||
is what embedding the screenshot and the source gives. Keeping `screen.png` beside
|
||||
the markdown as well is for looking at the picture on its own, without reading the
|
||||
document around it.
|
||||
|
||||
The frontmatter on `DESIGN.md` — `type`, `title`, `description`, `tags`,
|
||||
`status` — is also valid concept frontmatter, so these files are readable as
|
||||
concepts if the mockups are ever folded into a knowledge bundle.
|
||||
|
||||
# Notes
|
||||
|
||||
* The export shipped `DESIGN.md` and nothing else for the infrastructure folder.
|
||||
That folder is the design-token document, not a screen, so it deliberately has
|
||||
no `code.html` and no `screen.png`.
|
||||
* A second, byte-identical copy of the export was deleted. Equality was checked
|
||||
file by file with `cmp` across all 13 files before anything was removed.
|
||||
* Committed as `docs(design): embed screenshot and source into per-screen DESIGN.md`.
|
||||
Reference in new issue
Block a user