transformer-self-attention-page#104
Conversation
…as a first-class concept
…self-attention page]
…scoverable through related docs and search]
… for the new page contract]
|
Completed the self-attention canonical page slice on the current head. Changes now on this PR:
No PR conversation feedback was present before this update. GitHub CI for this pushed head is currently in progress. |
… for the new page contract]
|
Addressed the latest CI mergeability failures on the current head. Concrete fix in
Validation on this head:
This addresses the previously failing GitHub |
|
Mergeability follow-up on the current reviewed head
Local validation repeated in this reconciliation pass:
|
…r the new page contract
|
Addressed the latest CI mergeability failure on head Concrete fix:
Local validation on this head:
This addresses the prior GitHub |
… for the new page contract]
|
Addressed the latest Concrete fix:
Why this was the right fix:
Local validation on this head:
This addresses the prior GitHub |
… for the new page contract]
|
Addressed the latest live Concrete fix:
Local validation on this head:
There is still no external PR conversation feedback on this PR; the new push is only to fix the current head build-export mergeability blocker. |
|
Reconciled the current reviewed head with no source changes. What I verified on 48bcd68:
Mergeability follow-up:
At this point the only remaining blocker is fresh in-flight CI on the current head, not unresolved feedback or a locally reproducible branch failure. |
|
Reconciled the current reviewed head with no source changes. What I verified on :
Changes now on this PR:
No PR conversation feedback was present before this update. GitHub CI for this pushed head is currently in progress.author: AndreasAbdi
|
|
Superseding the previous CI note with the current state. What changed after that update:
Current verified state on 48bcd68:
There is still no reviewer-authored blocking PR conversation feedback on this PR. The only remaining blocker is fresh in-flight CI on the current head. |
|
Reconciled the current reviewed head with no source changes. What I verified on
Mergeability follow-up in UTC:
There is still no unresolved PR conversation feedback on this PR. The only remaining blocker is fresh in-flight CI on the current reviewed head. |
|
Superseding the previous CI note with the current state. What changed after that update:
Current verified state on
There is still no unresolved PR conversation feedback on this PR. The only remaining blocker is fresh in-flight CI on the current reviewed head. |
|
Reconciled the current reviewed head with no source changes. What I verified on
Mergeability follow-up in UTC:
There is still no unresolved PR conversation feedback on this PR. The only remaining blocker is fresh in-flight CI on the current reviewed head. |
|
Reconciled the current reviewed head with no source changes. What I verified on
Mergeability follow-up in UTC:
There is still no unresolved reviewer PR-conversation feedback on this PR. The only remaining blocker is fresh in-flight CI on the current reviewed head. |
1 participant
{
"project": "Model Atlas — Transformer Self-Attention Canonical Page",
"branchName": "transformer-self-attention-page",
"description": "Publish one canonical English
self-attentionconcept page, backed by registry data and localized messages, so readers can discover a broad self-attention explainer through search, tags, and related docs and then branch into nearby transformer and attention-variant pages.","context": {
"customerAsk": "Add one canonical English docs page for
self-attention, including the colocatedmessages/en.json, any requiredassets.json, and the matching registry record. Wire tags, groupings, aliases, and related-doc/search behavior soself-attentionis treated as a broad attention concept rather than a variant-specific module surface. Keep the slice English-only and add only the focused validation needed for registry/message integrity plus page-specific routing or related-doc expectations.","problem": "The site has a generic
attentionmodule page and several attention-variant module pages, but it does not yet publishself-attentionas its own canonical concept. Becauseself-attentioncurrently appears inside module-level metadata instead of as a first-class concept page, readers cannot reliably search for or navigate to a broad explainer that distinguishes self-attention from the overall attention family and from concrete variants such as multi-head attention or grouped-query attention.","solution": "Create a published
concept.self-attentionregistry record and a canonical/docs/concepts/self-attentionpage with English-only localized content. Update tags, aliases, and related relationships so search and related-doc surfaces presentself-attentionas a broad concept and route readers onward totransformer-architecture,attention,token,multi-head-attention, andgrouped-query-attention. Add focused automated checks for the page contract and discovery behavior."},
"acceptanceCriteria": [
"A published canonical docs page exists for
self-attentionwith a matching concept registry record, English messages, and any required local assets.","The page follows canonical docs writing rules with one folded
openingSummary, layperson-friendly tone, acronym expansion on first use, concrete tradeoffs, and no phase/process/meta language.","Search, tags, aliases, and related-doc surfaces treat
self-attentionas a broad attention concept instead of only as an alias on a module or variant page.","The page gives readers clear paths to
transformer-architecture,attention,token,multi-head-attention, andgrouped-query-attention, with no broken or misleading related links among shipped pages.","Focused validation covers registry/message integrity plus the page-specific route and at least one search or related-doc expectation for
self-attention.","Quality gate: make typecheck, make lint, and make test pass."
],
"userStories": [
{
"id": "transformer-self-attention-page-001",
"title": "Carve out self-attention as a first-class concept",
"description": "As a reader searching for self-attention, I want the site to recognize it as its own broad concept so I do not have to infer it from only the generic attention page or from variant pages.",
"acceptanceCriteria": [
"A published concept registry record exists for
self-attentionwith a stable id, canonical slug, broad attention tags, and aliases that cover representative spaced and hyphenated query forms.","Registry relationships link
self-attentiontotransformer-architecture,attention,token,multi-head-attention, andgrouped-query-attentionin roles that match a broad concept page rather than a variant page.","The surrounding attention metadata no longer leaves
self-attentiondiscoverable only through module-level aliasing on the genericattentionpage.","Typecheck passes",
"Tests pass"
],
"priority": 1,
"passes": true,
"notes": ""
},
{
"id": "transformer-self-attention-page-002",
"title": "Publish the canonical self-attention page",
"description": "As a technical layperson learning transformers, I want a dedicated self-attention page so I can understand what it is, why it matters, how it works inside a transformer block, and what tradeoffs it brings.",
"acceptanceCriteria": [
"A canonical concept page exists at
/docs/concepts/self-attentionwith matching frontmatter,messages/en.json, and any required localassets.json.","The page opens with one folded
openingSummaryand explains self-attention in plain language before narrowing into transformer usage.","The page links out where genuinely helpful to
transformer-architecture,attention,token,multi-head-attention, andgrouped-query-attention.","The page distinguishes self-attention from broader attention as a family and from nearby variants without turning into a benchmark or paper-download page.",
"Typecheck passes",
"Tests pass",
"Verify in browser using the Browser plugin"
],
"priority": 2,
"passes": true,
"notes": ""
},
{
"id": "transformer-self-attention-page-003",
"title": "Make self-attention discoverable through related docs and search",
"description": "As a reader exploring attention topics, I want search and related-doc surfaces to guide me to the self-attention explainer and then onward to nearby concept and module pages.",
"acceptanceCriteria": [
"Representative queries such as
self-attentionandself attentionreturn the canonicalself-attentionpage as a direct result rather than only the genericattentionmodule page.","The
self-attentionpage renders related docs and tag surfaces that show it as part of the broad attention cluster, including navigable links to shipped nearby pages.","At least one neighboring shipped page or surface presents
self-attentionas a related concept so readers can reach it without knowing the exact slug first.","Browser-visible rendering shows title, summary, tags, and related-doc links without missing-content placeholders or broken links.",
"Typecheck passes",
"Tests pass",
"Verify in browser using the Browser plugin"
],
"priority": 3,
"passes": true,
"notes": ""
},
{
"id": "transformer-self-attention-page-004",
"title": "Add focused validation for the new page contract",
"description": "As a maintainer, I want targeted automated proof for the self-attention slice so registry, message, route, and discovery regressions are caught without broad unrelated test expansion.",
"acceptanceCriteria": [
"Validation or test coverage confirms the
self-attentionpage route, registry record, and default English messages resolve together.","Coverage asserts at least one page-specific related-doc or search expectation for
self-attention.","Coverage stays focused on observable behavior for this page slice and does not require unrelated inventory snapshots or meta-test scaffolding.",
"Typecheck passes",
"Tests pass"
],
"priority": 4,
"passes": true,
"notes": ""
}
]
}