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

Give ids to all entries in the behavior lists #366

Merged
merged 24 commits into from
Feb 7, 2024
Merged

Conversation

frivoal
Copy link
Contributor

@frivoal frivoal commented Jan 30, 2024

This enables linking directly to a specific entry, to make it easier to reference individual entries

This does not change any of the wording in any part of the document (class 1 change, in Process terminology)


Preview | Diff

This enables linking directly to a specific entry.

This does not change any of the wording in any part of the document
(class 1 change, in Process terminology)
Copy link

@dbooth-boston dbooth-boston left a comment

Choose a reason for hiding this comment

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

Thanks for doing this! I made several suggestions, mostly intended to help the anchors better survive potential future edits and additions.

index.html Outdated Show resolved Hide resolved
index.html Outdated Show resolved Hide resolved
index.html Outdated Show resolved Hide resolved
index.html Outdated Show resolved Hide resolved
index.html Outdated Show resolved Hide resolved
index.html Outdated Show resolved Hide resolved
index.html Outdated Show resolved Hide resolved
index.html Outdated Show resolved Hide resolved
index.html Outdated Show resolved Hide resolved
index.html Outdated Show resolved Hide resolved
@frivoal
Copy link
Contributor Author

frivoal commented Jan 31, 2024

Thanks @dbooth-boston, I accepted all the suggestions. I am unsure how much it matters to have good phraising for the ids, but to the extent it does, your suggestions seemed like improvements.

Fixing the inappropriate id.
index.html Outdated Show resolved Hide resolved
@wareid wareid merged commit 54b1ca2 into w3c:main Feb 7, 2024
@nigelmegitt
Copy link
Collaborator

It's very opaque to viewers of the page that these IDs exist. Is there anything we can do (maybe in CSS?) to expose the links with fragment IDs? I'm thinking about the hover-over chain link icon pattern, though I'm unsure about the accessibility of only offering the link that way.

@wareid
Copy link
Collaborator

wareid commented Feb 8, 2024

It's very opaque to viewers of the page that these IDs exist. Is there anything we can do (maybe in CSS?) to expose the links with fragment IDs? I'm thinking about the hover-over chain link icon pattern, though I'm unsure about the accessibility of only offering the link that way.

I don't disagree @nigelmegitt, I wonder if this might be a respec recommendation though? I could probably work something into the document but it would be a hack and might be better to have built into respec.

@frivoal frivoal deleted the linkability branch February 8, 2024 20:21
@frivoal
Copy link
Contributor Author

frivoal commented Feb 8, 2024

Bikeshed makes this kind of thing a lot more easily discoverable, by adding a hoverable gray "§" in the margin of any such links, but respec currently doesn't. It'd be great if it did.

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