SMP window fills and centres instead of top-aligning; require opencode.md sync alongside README
This commit is contained in:
parent
d540a6a873
commit
10135b3d36
3 changed files with 28 additions and 17 deletions
39
opencode.md
39
opencode.md
|
|
@ -5,22 +5,29 @@ a minute. Read this first, then skim the files it points at.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Keep README.md in sync — do this on EVERY prompt
|
## Keep README.md AND opencode.md in sync — do this on EVERY prompt
|
||||||
|
|
||||||
**Before you finish any task, update `README.md` so it still matches the code.**
|
**Before you finish any task, update the docs so they still match the code.**
|
||||||
This is a standing requirement, not a one-off. The README is meant to describe the
|
This is a standing requirement, not a one-off, so treat it as part of "done":
|
||||||
project as it is right now, so treat it as part of "done":
|
|
||||||
|
|
||||||
- If a change adds/removes/renames a feature, script, route, app, theme, file or
|
**`README.md`** is the user/contributor-facing doc. If a change adds/removes/renames
|
||||||
dependency, reflect it in `README.md` (Features, Tech Stack, API Routes, Project
|
a feature, script, route, app, theme, file or dependency, reflect it in `README.md`
|
||||||
Structure, Scripts, running/deploying sections — whichever apply).
|
(Features, Tech Stack, API Routes, Project Structure, Scripts, running/deploying
|
||||||
- Re-read `README.md` and the files you touched; fix anything the change made stale.
|
sections — whichever apply).
|
||||||
- Keep the author's voice and existing emoji-section formatting; don't rewrite the
|
|
||||||
whole thing when a small edit will do.
|
|
||||||
- If a task genuinely changes nothing user- or contributor-visible, it's fine to
|
|
||||||
leave the README untouched — use judgement, don't churn it for nothing.
|
|
||||||
|
|
||||||
When in doubt, prefer updating it. A stale README is treated as a bug.
|
**`opencode.md`** (this file) is the cold-boot doc for the next session. Update it in
|
||||||
|
the same task whenever a change touches anything it describes — architecture, the key
|
||||||
|
files and their invariants, conventions/gotchas, history, or testing notes. A stale
|
||||||
|
`opencode.md` is worse than none: it actively misleads the next session.
|
||||||
|
|
||||||
|
For both docs:
|
||||||
|
- Re-read the doc and the files you touched; fix anything the change made stale.
|
||||||
|
- Keep the author's voice and existing formatting; don't rewrite the whole thing when
|
||||||
|
a small edit will do.
|
||||||
|
- If a task genuinely changes nothing that either doc describes, it's fine to leave
|
||||||
|
that doc untouched — use judgement, don't churn it for nothing.
|
||||||
|
|
||||||
|
When in doubt, prefer updating. A stale README **or** opencode.md is treated as a bug.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -244,9 +251,9 @@ list reordering, not free placement. Don't confuse the two.
|
||||||
|
|
||||||
## After finishing — push to git
|
## After finishing — push to git
|
||||||
|
|
||||||
First make sure `README.md` is up to date (see "Keep README.md in sync" at the
|
First make sure `README.md` **and** `opencode.md` are up to date (see "Keep
|
||||||
top), then run **only** these three commands (no extra flags, no rebasing, no
|
README.md AND opencode.md in sync" at the top), then run **only** these three
|
||||||
force-push):
|
commands (no extra flags, no rebasing, no force-push):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git add .
|
git add .
|
||||||
|
|
|
||||||
|
|
@ -752,7 +752,7 @@ export const SMP_APP: AppDef = {
|
||||||
icon: "🎮",
|
icon: "🎮",
|
||||||
color: "#c0392b",
|
color: "#c0392b",
|
||||||
width: 560,
|
width: 560,
|
||||||
height: 430,
|
height: 400,
|
||||||
content: <SmpApp />,
|
content: <SmpApp />,
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -625,7 +625,11 @@ a.win-icon {
|
||||||
.smp {
|
.smp {
|
||||||
display: flex;
|
display: flex;
|
||||||
flex-direction: column;
|
flex-direction: column;
|
||||||
|
justify-content: center;
|
||||||
gap: 14px;
|
gap: 14px;
|
||||||
|
/* Fill the window body so the menu centres instead of leaving a gap under it;
|
||||||
|
a short window scrolls via .win-body's overflow. */
|
||||||
|
min-height: 100%;
|
||||||
font-family: "Monocraft", "JetBrains Mono", monospace;
|
font-family: "Monocraft", "JetBrains Mono", monospace;
|
||||||
color: #e6e6e6;
|
color: #e6e6e6;
|
||||||
background-color: #313131;
|
background-color: #313131;
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue