Skip to content

[structure] needs an overhaul #2528

Description

@zygoloid

Looking through [structure], we find:

  • [structure.elements] does not correctly describe any of the library clauses. There is no "Summary" subclause, no "Detailed specifications" subclause, the references to the C library are not collected together as is suggested therein. And what is an "element" anyway?
  • [structure.summary]'s first sentence might be approximately correct, but the second sentence is not. And the second paragraph doesn't seem to provide any expositionary value whatsoever.
  • [structure.specifications]: bullet 1.1 is not something we really do; paragraph 2 belongs on our wiki not in the working draft
  • [structure.see.also] has a suspicious section name

There's lots of scope for improvements here.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    lwgIssue must be reviewed by LWG.

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions