Skip to content

docs

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

docs

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
architecture-hardening
architecture-hardening
 
 
README.ja.md
README.ja.md
 
 
README.md
README.md
 
 
a11y-design.md
a11y-design.md
 
 
a11y-impl-plan.md
a11y-impl-plan.md
 
 
a11y-sr-testing.ja.md
a11y-sr-testing.ja.md
 
 
a11y-sr-testing.md
a11y-sr-testing.md
 
 
app-testing-and-typescript-impl-plan.md
app-testing-and-typescript-impl-plan.md
 
 
array-mutation-diagnostic-design.md
array-mutation-diagnostic-design.md
 
 
async-execution-model.ja.md
async-execution-model.ja.md
 
 
async-execution-model.md
async-execution-model.md
 
 
async-io-node-guidelines.ja.md
async-io-node-guidelines.ja.md
 
 
async-io-node-guidelines.md
async-io-node-guidelines.md
 
 
audio-impl-plan.ja.md
audio-impl-plan.ja.md
 
 
audio-impl-plan.md
audio-impl-plan.md
 
 
audio-tag-design.md
audio-tag-design.md
 
 
binder-protocol-design.md
binder-protocol-design.md
 
 
camera-recorder-impl-plan.md
camera-recorder-impl-plan.md
 
 
camera-recorder-tag-design.md
camera-recorder-tag-design.md
 
 
contact-picker-tag-design.md
contact-picker-tag-design.md
 
 
credential-tag-design.md
credential-tag-design.md
 
 
csp.ja.md
csp.ja.md
 
 
csp.md
csp.md
 
 
custom-state-reflection-design.ja.md
custom-state-reflection-design.ja.md
 
 
custom-state-reflection-design.md
custom-state-reflection-design.md
 
 
defined-impl-plan.md
defined-impl-plan.md
 
 
defined-tag-design.md
defined-tag-design.md
 
 
dependency-walk-ordering.md
dependency-walk-ordering.md
 
 
device-orientation-tag-design.md
device-orientation-tag-design.md
 
 
devtools-hook-protocol.ja.md
devtools-hook-protocol.ja.md
 
 
devtools-hook-protocol.md
devtools-hook-protocol.md
 
 
devtools-tag-design.md
devtools-tag-design.md
 
 
distribution-robustness-impl-plan.md
distribution-robustness-impl-plan.md
 
 
examples-uncovered-combos.md
examples-uncovered-combos.md
 
 
eyedropper-tag-design.md
eyedropper-tag-design.md
 
 
form-tag-design.md
form-tag-design.md
 
 
framework-adapter-integration.ja.md
framework-adapter-integration.ja.md
 
 
framework-adapter-integration.md
framework-adapter-integration.md
 
 
fullscreen-tag-design.md
fullscreen-tag-design.md
 
 
getter-dependency-ast-impl-plan.md
getter-dependency-ast-impl-plan.md
 
 
go-to-market-2026-08-council.md
go-to-market-2026-08-council.md
 
 
go-to-market-2026-08-synthesis-review.md
go-to-market-2026-08-synthesis-review.md
 
 
go-to-market-2026-08.md
go-to-market-2026-08.md
 
 
i18n-design.md
i18n-design.md
 
 
i18n-impl-plan.md
i18n-impl-plan.md
 
 
idle-detection-tag-design.md
idle-detection-tag-design.md
 
 
io-node-batch-implementation-plan.md
io-node-batch-implementation-plan.md
 
 
io-node-candidate-implementation-notes.md
io-node-candidate-implementation-notes.md
 
 
io-node-candidate-screening.md
io-node-candidate-screening.md
 
 
io-node-trace-conformance.md
io-node-trace-conformance.md
 
 
list-replacement-dependency-scaling.md
list-replacement-dependency-scaling.md
 
 
media-query-tag-design.md
media-query-tag-design.md
 
 
midi-tag-design.md
midi-tag-design.md
 
 
migration-v2.ja.md
migration-v2.ja.md
 
 
migration-v2.md
migration-v2.md
 
 
multi-promise-io-node-design.md
multi-promise-io-node-design.md
 
 
network-tag-design.md
network-tag-design.md
 
 
notification-tag-design.md
notification-tag-design.md
 
 
permission-tag-design.md
permission-tag-design.md
 
 
picture-in-picture-tag-design.md
picture-in-picture-tag-design.md
 
 
pointer-lock-tag-design.md
pointer-lock-tag-design.md
 
 
project-strategy-2026-07.md
project-strategy-2026-07.md
 
 
raf-impl-plan.md
raf-impl-plan.md
 
 
raf-tag-design.md
raf-tag-design.md
 
 
router-state-contract-design.md
router-state-contract-design.md
 
 
scoped-custom-element-registries.ja.md
scoped-custom-element-registries.ja.md
 
 
scoped-custom-element-registries.md
scoped-custom-element-registries.md
 
 
screen-orientation-tag-design.ja.md
screen-orientation-tag-design.ja.md
 
 
screen-orientation-tag-design.md
screen-orientation-tag-design.md
 
 
sensor-tag-design.md
sensor-tag-design.md
 
 
signals-definition-timing.ja.md
signals-definition-timing.ja.md
 
 
signals-definition-timing.md
signals-definition-timing.md
 
 
signals-jsx-setup.md
signals-jsx-setup.md
 
 
signals-migration-plan.md
signals-migration-plan.md
 
 
signals-state-design.ja.md
signals-state-design.ja.md
 
 
signals-state-design.md
signals-state-design.md
 
 
spec-proposal-bind-definition-timing.md
spec-proposal-bind-definition-timing.md
 
 
spec-proposal-command-token-arguments.md
spec-proposal-command-token-arguments.md
 
 
spec-proposal-undefined-write-skip.md
spec-proposal-undefined-write-skip.md
 
 
speech-tag-design.md
speech-tag-design.md
 
 
sri.ja.md
sri.ja.md
 
 
sri.md
sri.md
 
 
ssr-router-design.md
ssr-router-design.md
 
 
state-bind-component-nested-for-design.md
state-bind-component-nested-for-design.md
 
 
state-binding-init-races.ja.md
state-binding-init-races.ja.md
 
 
state-binding-init-races.md
state-binding-init-races.md
 
 
state-cross-state-read-design.md
state-cross-state-read-design.md
 
 
state-deactivated-content-stale-update.md
state-deactivated-content-stale-update.md
 
 
state-event-lane-design.md
state-event-lane-design.md
 
 
state-list-key-design.md
state-list-key-design.md
 
 
state-mount-design.md
state-mount-design.md
 
 
state-mount-impl-plan.md
state-mount-impl-plan.md
 
 
state-named-wildcard-index-design.md
state-named-wildcard-index-design.md
 
 
state-overlay-export-design.md
state-overlay-export-design.md
 
 
state-recursive-path-design.md
state-recursive-path-design.md
 
 
state-recursive-path-impl-plan.md
state-recursive-path-impl-plan.md
 
 
state-redesign-council.md
state-redesign-council.md
 
 
state-redesign-route-a.md
state-redesign-route-a.md
 
 
state-row-instantiation-redesign.md
state-row-instantiation-redesign.md
 
 
state-scan-design.md
state-scan-design.md
 
 

README.md

wcstack docs

Design documents, implementation plans, and spec proposals. Per-package README.md remains the normative reference for that package's public surface; the documents here cover cross-package contracts and the reasoning behind them.

日本語版: README.ja.md

Naming convention

Suffix Language
<name>.md English (canonical)
<name>.ja.md 日本語

Four rules go with it:

  1. Links stay within a language. An English document links to other.md; the Japanese one links to other.ja.md. Never mix, so a reader never falls out of their language mid-chain.
  2. While the migration is unfinished, a link from an English document to a not-yet-translated file is marked (ja) on first mention — repeating it on every inline line-link to the same document would be noise. That is honest about where the reader lands. Drop the marker when the target is translated.
  3. Rename only when the English version is ready. Moving a Japanese file to .ja.md before its .md exists breaks every existing reference to docs/<name>.md from code, examples, and READMEs.
  4. A reference to a file that no longer exists is a commit permalink. A relative link 404s and the line numbers cited alongside it stop meaning anything, so point at the last commit that still had the file — https://github.com/wcstack/wcstack/blob/<full-sha>/<path>#L<n> — and name the deleting commit on first mention. This is the one place absolute URLs are correct; everything that still exists stays relative. The synth-playground prototype wcs-synth.js (deleted in cbd5598e, cited at 1e26a2a9) is the case this rule was written for.

Migration status

.md files not listed below are still Japanese; they are translated on demand, priority given to whatever code or a README points at.

Translated

Doc 日本語
csp.md csp.ja.md
sri.md sri.ja.md
framework-adapter-integration.md framework-adapter-integration.ja.md
async-execution-model.md async-execution-model.ja.md
async-io-node-guidelines.md async-io-node-guidelines.ja.md
timing-and-firing-contract.md timing-and-firing-contract.ja.md
a11y-sr-testing.md a11y-sr-testing.ja.md
devtools-hook-protocol.md devtools-hook-protocol.ja.md
custom-state-reflection-design.md custom-state-reflection-design.ja.md
signals-definition-timing.md signals-definition-timing.ja.md
signals-state-design.md signals-state-design.ja.md
state-binding-init-races.md state-binding-init-races.ja.md
typescript.md typescript.ja.md
scoped-custom-element-registries.md scoped-custom-element-registries.ja.md
screen-orientation-tag-design.md screen-orientation-tag-design.ja.md
audio-impl-plan.md audio-impl-plan.ja.md
view-transition-design.md view-transition-design.ja.md
architecture-hardening/README.md README.ja.md
architecture-hardening/09-remediation-design.md 09…ja.md
architecture-hardening/10-defaulting-rollout-status.md 10…ja.md
architecture-hardening/12-wc-bindable-observable-inventory.md 12…ja.md
architecture-hardening/13-framework-adapter-binding-constraints.md 13…ja.md
architecture-hardening/14-handle-graph-wiring.md 14…ja.md
architecture-hardening/15-state-component-mechanism-consistency.md 15…ja.md
migration-v2.md migration-v2.ja.md

That is the whole priority set — every document code, an example, or a README points at. What remains untranslated is the internal design notes and implementation plans (*-tag-design.md, *-impl-plan.md, state-*.md, io-node-*.md, architecture-hardening/01-08, 11), translated on demand as they are touched.

Staying Japanese — internal strategy and council records

These are internal working documents, not part of the published surface, so they keep a Japanese .md and get no English counterpart:

  • go-to-market-2026-08.md, go-to-market-2026-08-council.md, go-to-market-2026-08-synthesis-review.md
  • project-strategy-2026-07.md
  • state-redesign-council.md