ampproject / ampproject/amp.dev

> When the [kbd](https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-kbd-element) element is nested inside a [samp](https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-samp-element) element, it represents the input as it was echoed by the system.

Open
#6,333 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
600
Forks
675
PR merge metrics
No merged PRs in 30d

Description

> When the [kbd](https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-kbd-element) element is nested inside a [samp](https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-samp-element) element, it represents the input as it was echoed by the system.
>
> When the [kbd](https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-kbd-element) element contains a [samp](https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-samp-element) element, it represents input based on system output, for example invoking a menu item.
>
> When the [kbd](https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-kbd-element) element is nested inside another [kbd](https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-kbd-element) element, it represents an actual key or other single unit of input as appropriate for the input mechanism.

https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-kbd-element

Basically semantics wankery, and maybe we should change it...

_Originally posted by @zcorpan in https://github.com/whatwg/html/issues/7672#issuecomment-1056005968_

Contributor guide

Open the contributing guide

Research direction

Start with the linked WHATWG HTML specification section and inspect the amp.dev repository for documentation using the kbd and samp elements. The issue names no file, test, or specific content change; clarify the intended semantics and target before defining what done means.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.