Documentation: PR for curation of 6.5 symbols

We've got a PR up that organizes the new 6.5 symbols like Cell and TaskID into their proper places in the documentation.

More details in the PR description. Feel free to leave a comment or question. Thanks.

2 Likes

Not sure if this is too quibbly to comment on, but I noticed some case inconsistency in the headings that might be of interest. In the span sections there's a minor mismatch in "Span" vs. "raw span", with sentence case being preferred, but then later in the docs for Optional, Hasher, Dictionary it's title case throughout.

That's valid. Apple has been moving to sentence case for topics, but there's such a legacy of title case in the stdlib docs, and no intention of changing all of it, that I should probably just make everything title case for consistency with what's already here.

I'll fix that on first commit tomorrow, thanks.

Cool. In these instances where the type name is so similar to what the thing actually is, the extra capitals would sometimes obscure the intended meaning, and maybe title case feels bellowy but personally I read it as a sign of authority. Thanks for the extra info.

Standardized the capitalization in 16830b9.

2 Likes