This repo ships three README files: README.md, README.en.md and README.es.md. README.md is already a near-copy of the English version and links to it as "detailed documentation" — so English content lives in two files that nobody keeps in sync.
The same layout exists in Shell.ddd and Shell.Factory, while Shell.Bootstrapper has only README.md + README.es.md. So the family is inconsistent on top of being duplicated.
Proposal: README.md becomes the English document and the single source of truth, with a language switcher at the top; README.en.md is deleted; README.es.md stays as the translation. Apply the same layout across all four Shell.* repos.
Acceptance criteria
Where
README.md, README.en.md, README.es.md.
This repo ships three README files:
README.md,README.en.mdandREADME.es.md.README.mdis already a near-copy of the English version and links to it as "detailed documentation" — so English content lives in two files that nobody keeps in sync.The same layout exists in
Shell.dddandShell.Factory, whileShell.Bootstrapperhas onlyREADME.md+README.es.md. So the family is inconsistent on top of being duplicated.Proposal:
README.mdbecomes the English document and the single source of truth, with a language switcher at the top;README.en.mdis deleted;README.es.mdstays as the translation. Apply the same layout across all fourShell.*repos.Acceptance criteria
README.en.mdremoved, with any content unique to it merged intoREADME.md.README.en.md.Where
README.md,README.en.md,README.es.md.