In comments, we often cite and quote the current Working Paper. Over the years, its sections are renumbered and its wording changes due to features being added, library issues being resolved, and editorial issues being cleaned up. This is especially true after a recent overhaul of Constraints/Mandates/Requires/etc. elements.
We should clean up these old comments (and static_assert messages), which involves:
- Citing the now-current Working Paper
- Dropping the section number
- Checking that the stable name is still accurate (these rarely change, but it happens)
- Updating the paragraph numbers if they have changed
- Updating any quoted wording (making sure to clean out non-ASCII characters like long dashes)
In comments, we often cite and quote the current Working Paper. Over the years, its sections are renumbered and its wording changes due to features being added, library issues being resolved, and editorial issues being cleaned up. This is especially true after a recent overhaul of Constraints/Mandates/Requires/etc. elements.
We should clean up these old comments (and
static_assertmessages), which involves:reference_wrapperandthread#3101 (comment) for rationale - section numbers are basically noise, they change too frequently, and searching for[stable.name]is fast