Skip to content

[css-writing-modes] section/subsection confusion sort of marks 'writing-mode' as non-normative #1307

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

Closed
dbaron opened this issue Apr 29, 2017 · 4 comments
Labels
Closed Accepted as Editorial Commenter Satisfied Commenter has indicated satisfaction with the resolution / edits. css-writing-modes-3 Tracked in DoC

Comments

@dbaron
Copy link
Member

dbaron commented Apr 29, 2017

§3. Introduction to Vertical Text begins with:

This subsection is non-normative.

This is odd, since it's really a section rather than a subsection.

Furthermore, the section contains §3.1. Block Flow Direction: the writing-mode property, which definitely needs to be normative.

It seems like this could use a little bit of clarification by moving the introductory material into an actual subsection (although that has the problem of a toplevel section with no content before the subsection begins), or something else to make it clearer that §3.1 is actually normative.

@fantasai
Copy link
Collaborator

fantasai commented May 2, 2017

It uses the word “subsection” instead of “section” to try to indicate that it applies only to the material before 3.1. Not sure what's a better way of indicating that...

@astearns
Copy link
Member

astearns commented May 2, 2017

What if we left the first sentence in the toplevel section (In addition…) then started a subsection immediately after and called it something like "Vertical Text Examples" and marked that subsection non-normative?

@astearns
Copy link
Member

astearns commented May 9, 2017

@fantasai please review and merge the PR if it looks OK to you. @dbaron is this change sufficient?

@dbaron
Copy link
Member Author

dbaron commented May 9, 2017

Looks fine to me. (No idea whether we should call it a section or a subsection, though.)

@astearns astearns added Closed Accepted as Editorial Commenter Satisfied Commenter has indicated satisfaction with the resolution / edits. labels May 17, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Closed Accepted as Editorial Commenter Satisfied Commenter has indicated satisfaction with the resolution / edits. css-writing-modes-3 Tracked in DoC
Projects
None yet
Development

No branches or pull requests

4 participants