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

[basic.ios.members] p16 has numbered list that should use bullets #505

Closed
jwakely opened this issue May 14, 2015 · 5 comments
Closed

[basic.ios.members] p16 has numbered list that should use bullets #505

jwakely opened this issue May 14, 2015 · 5 comments
Assignees

Comments

@jwakely
Copy link
Member

jwakely commented May 14, 2015

The definition of copyfmt in p16 has a numbered list with a bulletted list nested inside it, so only the inner list gets the new (16.1), 16.2) bullet numbering, which looks very odd.

@AlisdairM
Copy link
Contributor

It may look odd, but I think the format is intentional. The outer list is an ordered sequence of events, where the order matters. The inner bullet list states 3 properties of the copy behavior, but there is no relative sequencing between them, so the associated para-number for the bullet is not semantically useful, but provides a way to identify those sentences in the standard.

@jensmaurer
Copy link
Member

Maybe we want to give numbered lists the same "number-in-margin" treatment as bulleted lists?

@Eelis
Copy link
Contributor

Eelis commented Nov 23, 2016

For reference, here's a screenshot:

item

Another solution could be to keep the styling as-is, but change the numbers for the nested items to (16.2.1), (16.2.2), and (16.2.3), to reflect that they are nested in item 2 of para 16.

@jensmaurer jensmaurer added the decision-required A decision of the editorial group (or the Project Editor) is required. label Mar 29, 2017
@zygoloid
Copy link
Member

zygoloid commented Nov 7, 2017

Decision: add "then," to the start of the second, third, and fourth item, and convert to bullets.

[cmplx.over]: convert to bullets
[streambuf.virt.put]: p5 should be converted to bullets, first bullet is missing a period.

In general: where the numbers are not semantically important (eg, not for phases of translation), convert to bullets. Use words, not numbering, to indicate sequencing.

@zygoloid zygoloid removed the decision-required A decision of the editorial group (or the Project Editor) is required. label Nov 7, 2017
@jwakely jwakely self-assigned this Nov 7, 2017
@jwakely
Copy link
Member Author

jwakely commented Nov 8, 2017

Fixed at ee8aa52

@jwakely jwakely closed this as completed Nov 8, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

5 participants