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

Editorial: Move a note at the end of a spec step #10814

Merged
merged 3 commits into from
Dec 4, 2024

Conversation

shannonbooth
Copy link
Contributor

@shannonbooth shannonbooth commented Dec 3, 2024

Instead of at the front of the next one, which was resulting in some slightly strange looking rendering in: https://html.spec.whatwg.org/multipage/webappapis.html#resolve-a-module-specifier

Tried to follow the style guidelines as best as I can, as far as I can tell this looks like how notes are typically added. Though, it might make more sense if the note was instead moved to the end of that spec step instead of the bottom of the one proceeding it.


/webappapis.html ( diff )

@shannonbooth
Copy link
Contributor Author

shannonbooth commented Dec 3, 2024

hmm, I am not sure what I messed up with the branching.

edit: Should be resolved now

Instead of at the front of the next one, which was resulting in some
slightly off rendering.
Copy link
Member

@annevk annevk left a comment

Choose a reason for hiding this comment

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

source Outdated Show resolved Hide resolved
@annevk annevk requested review from domenic and yoavweiss December 3, 2024 08:56
Copy link
Contributor

@yoavweiss yoavweiss left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Member

@domenic domenic left a comment

Choose a reason for hiding this comment

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

I remember seeing this and it being awkward. However, I felt that since the note was talking about the state of the world before the step happened, it made sense to put it before the step.

I've suggested a compromise, which is to tweak the wording a bit in a way that hopefully avoids the confusion.

source Show resolved Hide resolved
Copy link
Member

@domenic domenic left a comment

Choose a reason for hiding this comment

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

Thanks!

@domenic domenic merged commit 6e6e538 into whatwg:main Dec 4, 2024
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

4 participants