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 · 2 comments
Open

Definition formating #4149

alastc opened this issue Nov 22, 2024 · 2 comments
Labels

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!

@mbgower mbgower added Errata Erratum to a Recommendation Editorial labels Nov 26, 2024
@mbgower
Copy link
Contributor

mbgower commented Nov 26, 2024

I've added additional labels to this because I suspect we may be able to get consensus that some of these are obviously unintentionally unformatted notes AND do not alter the meaning or interpretation if properly styled as notes.

As such, they are of a different nature of change than any that are perceived as potentially changing interpretation of the definition. I foresee that we may be splitting this off into two separate PRs. This issue may help us better iterative on our process for changes to the normative document.

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

No branches or pull requests

3 participants