Skip to content

docs: a README for the people who play, with both windows - #8

Merged
fcsouza merged 2 commits into
mainfrom
docs/readme-for-players
Sep 13, 2026
Merged

fcsouza merged 2 commits into
mainfrom
docs/readme-for-players

Conversation

@fcsouza

@fcsouza fcsouza commented Sep 13, 2026

Copy link
Copy Markdown
Contributor

The README opened with setting scopes and hid Install at line 130. Someone who lands here wants to install first.

What changes

  • Install moves to the top, with the path inside Foundry (Add-on Modules → Install Module) and the step that turns the module on in a world.
  • Two screenshots, taken from a real Foundry v14 with the SDK's container harness: the vault window after "What it does", the updates window in the updates section. The world is the test one, so the list holds two packages, and version 99.0.0 is seeded to draw the outdated row.
  • Headings drop the jargon. "The three scopes" → "What a profile carries". "Tags that are not versions" → "Releases it cannot read". "Credentials" → "Passwords and keys". "Why there is a button" → "Why nothing checks on its own". "What happens on import" → "What happens when you import".
  • "From a macro" becomes "The API, for macros and modules" and moves down beside Build from source and Running it in a real Foundry. All three are for developers and were scattered through the text a player reads.

Two defects along the way

  • The macro block declared const report twice. Pasted into a macro, it did not run.
  • The e2e section said 26 checks. It is 32, and it now includes the crossing between worlds.

One thing that is not text

module.json points readme at a path inside the module folder, so Foundry reads that README from there. An image under docs/ only resolves if docs/ ships in the zip, so it went into staticAssets. The zip goes from 66 KB to 280 KB.

Checked: unzip -l lists docs/vault-window.png and docs/updates-window.png at the package root.

No fact in the README changed, only the order and the words.

O arquivo abria com escopos de setting e escondia o Install na linha 130. Quem
chega quer instalar primeiro.

Install sobe para o topo, com o caminho dentro do Foundry e o passo de ligar o
modulo no mundo. Os titulos deixam o jargao: "The three scopes" vira "What a
profile carries", "Tags that are not versions" vira "Releases it cannot read",
"Credentials" vira "Passwords and keys", "From a macro" vira "The API, for
macros and modules" e desce para junto das secoes de quem desenvolve.

Duas capturas de tela entram, tiradas de um Foundry v14 de verdade: a janela do
cofre e a de atualizacoes. O manifesto aponta `readme` para dentro da pasta do
modulo, entao `docs` entra no zip junto, senao a imagem quebra para quem instala.

O bloco de macro declarava `report` duas vezes e nao rodava. E o numero de
checagens do e2e estava em 26; sao 32, e agora inclui a passagem entre mundos.
Everything tracked in this repo is written in English.
@fcsouza fcsouza changed the title docs: um README para quem joga, com as duas janelas docs: a README for the people who play, with both windows Sep 13, 2026
@fcsouza
fcsouza merged commit 03f858d into main Sep 13, 2026
1 check passed
@fcsouza
fcsouza deleted the docs/readme-for-players branch September 13, 2026 23:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant