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

US-1: Use unique bullets in bulleted lists #177

Closed
sdutoit opened this issue Sep 19, 2013 · 2 comments
Closed

US-1: Use unique bullets in bulleted lists #177

sdutoit opened this issue Sep 19, 2013 · 2 comments
Assignees
Labels
ballot-comment Response to an NB or ISO comment on a ballot big An issue causing a large set of changes, scattered across most of the text.

Comments

@sdutoit
Copy link
Contributor

sdutoit commented Sep 19, 2013

N3733 US-1 says:

In lists of specifications, the use of anonymous bullets makes it difficult (in correspondence and speech) to refer to individual list items. Moreover, the longer the list, the greater the opportunity to mistake the structure, most especially in the presence of bullets in sublists.

It goes on to propose:

In all lists of bulleted items, provide a distinct numbered or lettered identification in place of each bullet. Because paragraphs are already numbered, it seems best to use letters for top-level list items within paragraphs and then to use Roman numerals for any sublist items. (A few parts of the Standard already do this.)

@sdutoit
Copy link
Contributor Author

sdutoit commented Sep 27, 2013

NB Response is going to be:

We believe this is, in principle, a good suggestion, but the scope of this change makes it more appropriate to explore the options for enumeration of bullets in the C++17 timeframe prior to the issuance of a Committee Draft.

@zygoloid
Copy link
Member

Result of discussion: put <paragraph>.<bullet number> in the left margin next to each bullet (or <paragraph>.<bullet number>.<subbullet number> for deeper nesting).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
ballot-comment Response to an NB or ISO comment on a ballot big An issue causing a large set of changes, scattered across most of the text.
Projects
None yet
Development

No branches or pull requests

3 participants