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
Hanging paragraphs vs. warm-up introduction #1771
Comments
Editorial meeting consensus: There are several different situations that warrant different treatment.
|
Hanging paragraphs were summarily fixed by addressing an ISO/CS comment on DIS C++20. Keeping open to possibly reconsider the details of the new structure. |
https://www.iso.org/ISO-house-style.html#iso-hs-s-text-r-s-informative mentions
|
@JohelEGP , the "house style" is not as binding as the ISO Directives, Part 2, and we're not generally following the house style. At the very least, due to historical reasons (our standard is much older than the house style). As you should know, we traditionally use "shall" for requirements on the user and normal mood ("is") for requirements on the implementation, which is usually in the cases where we simply specify the C++ language and expect implementations to implement its rules. |
The ISO Directives, Part 2, require us to get rid of hanging paragraphs.
One sub-issue is that we sometimes have introductory warm-up sentences at the start of a clause or subclause. Occasionally, these are "note"s, making clear their non-normative character. On other occasions (e.g. [constraints.overview]), they are not. Sometimes those warm-up sentences are in a separate subclause "overview", sometimes they form "hanging paragraphs" (often together with normative material).
This issue serves as an anchor to discuss a uniform approach to dealing with these warm-up sentences. Ideas:
The text was updated successfully, but these errors were encountered: