Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Definition formating #4149

Open
alastc opened this issue Nov 22, 2024 · 1 comment
Open

Definition formating #4149

alastc opened this issue Nov 22, 2024 · 1 comment

Comments

@alastc
Copy link
Contributor

alastc commented Nov 22, 2024

Following on from #4122, it is apparent that some definitions have content that was intended as "notes" or "examples" which are not marked as such.

Looking down the glossary, there are a few definitions that are intended to be multi-line (e.g. accessibility-supported, changes of context). However, some multi-line definitions appear to be missing the markings for examples/notes.

In the abbreviation definition note one gets broken up. Looking back at WCAG 2.0 it shouldn't be. I think that's sufficiently confusing that you cannot work out what is normative or not, after the initial definition statement.

The following have content after the initial definition that I think was supposed to be a note or example.

There are others, but I've removed ones which I thought could affect interpretation.

I think "down event" and "up event" are obviously informative and don't affect the definition.

The CSS pixel one is explanatory, I'm struggling to see how you'd interpret the definition differently if it were (or were not) part of the normative text. Same for user inactivity, if it were intended to be a core part of the definition it would be phrased as "any continuous period of time where no user actions occurs that is tracked by the web site or application."

@bruce-usab
Copy link
Contributor

YIkes, 2.0 abbreviation Note 1 having its own Note 1!

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

No branches or pull requests

2 participants