Skip to content

Site dictionary#848

Open
bdenham wants to merge 4 commits intoreleasefrom
site-dictionary
Open

Site dictionary#848
bdenham wants to merge 4 commits intoreleasefrom
site-dictionary

Conversation

@bdenham
Copy link
Copy Markdown
Collaborator

@bdenham bdenham commented Apr 23, 2026

Purpose of this pull request

This pull request introduces a site-wide glossary with an inline Term component (dotted underlines and tooltips backed by src/data/glossary.ts). migrates a set of developer and merchant topics away from per-page Vocabulary / clustered definitions toward in-context, just-in-time use of Term where it helps. As a result of correcting terms that were not adequately defined in the merchant docs, I added a merchant “How block tables work” page so block-table mechanics are explained once and linked from hubs and task pages.

Associated JIRA ticket

TBD

Staging preview

A few pages that were converted from Vocabulary sections to in-context definitions (identified with a dotted underline for the word or phrase)

https://commerce-docs.github.io/microsite-commerce-storefront/merchants/quick-start/block-tables/
https://commerce-docs.github.io/microsite-commerce-storefront/merchants/content-customizations/experiments/
https://commerce-docs.github.io/microsite-commerce-storefront/get-started/create-storefront/

Affected pages

Use the production experience base: https://experienceleague.adobe.com/developer/commerce/storefront

New topic

Merchants (hub, quick start, blocks, personalization, content customizations)

Drop-ins (all)

@bdenham bdenham requested a review from keharper April 23, 2026 15:21
@bdenham bdenham self-assigned this Apr 23, 2026
@bdenham bdenham added javascript Pull requests that update javascript code major-update Significant original updates to existing content new-topic A major update published as an entirely new document feedback Update based on internal or external stakeholder feedback labels Apr 23, 2026
@bdenham bdenham marked this pull request as ready for review April 23, 2026 16:22
Copy link
Copy Markdown
Contributor

@keharper keharper left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice work. See if you can find a way to make the Term indicator to stand out a little more without making it scream. Or maybe add a tiny icon to help make it visible.

@bdenham
Copy link
Copy Markdown
Collaborator Author

bdenham commented Apr 23, 2026

I'll try some ideas to run by you tomorrow.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feedback Update based on internal or external stakeholder feedback javascript Pull requests that update javascript code major-update Significant original updates to existing content new-topic A major update published as an entirely new document

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants