organizes new articles into the existing pages for descriptions and groups #82350
Conversation
|
@swift-ci please test |
| @@ -31,4 +33,5 @@ Or upgrade all warnings except deprecated declaration to errors: | |||
| - <doc:strict-language-features> | |||
| - <doc:strict-memory-safety> | |||
| - <doc:unknown-warning-group> | |||
|
|
|||
| - <doc:availability-unrecognized-name> | |||
| - <doc:missing-module-on-known-paths> | |||
There was a problem hiding this comment.
Ah... I really need to add that check I said I'd add in 😬 Thanks for adding these. I know you didn't add it, but would you like to summarize the initial paragraph in missing-module-on-known-paths? It's a bit long for the one-liner IMO.
EDIT: Also, mind making the additions alphabetical?
There was a problem hiding this comment.
I don't have a sense for the size this will grow to, but if the list gets notably longer, it would make a lot of sense to start looking for ways to group these rather than utilizing alphabetical organization. And even that's tricky, as not all the markdown file names align to the titles in those articles. Changing the markdown file name will change the the URL that the page is pinned out, so if you're referencing these externally - I'd recommend being quite strict about those changes, and maybe building up a convention of always naming the markdown file after the name of the Group or Diagnostic.
I'd be happy to retrofit the markdown file name in a separate PR if you'd like to go that route.
|
@swift-ci please test |
Updates the curation (organization) for the newer articles in diagnostics.
3 articles were floating below the organized pages - this merges them into those groups.
Reviewed manually with:
cd userdocs xcrun docc preview diagnostics --allow-arbitrary-catalog-directories