Who to ping about a PR that fixes an outdated link?

icanzilb · 2022-05-18T08:50:05.910Z

I wanted to share the Swift API Guidelines with my team but there's an old (and confusing) link right at the top.

I made a PR on GitHub - apple/swift-internals but there is not CONTRIBUTING.md file with directions (maybe also something to fix?) and there is no reviewers assigned automatically as on other apple repos.

Who should I ping to move forward with: Replaces archived and outdated documentation link with a current article by icanzilb · Pull Request #31 · apple/swift-internals · GitHub?

Thank you

alexandersandberg · 2022-05-18T08:59:20.061Z

Hi Marin,

Thanks for contributing!

The official version of the API Design Guidelines lives at https://www.swift.org/documentation/api-design-guidelines/, and it would be great if you could open a PR on the Swift.org repo instead.

icanzilb · 2022-05-18T09:14:22.208Z

Hi @alexandersandberg, before I disagree, could you point me to the file in that repo that I should be working on instead?

alexandersandberg · 2022-05-18T09:28:37.067Z

Sorry, I was a bit quick there! The API Design Guidelines do not actually live in apple/swift-org-website. Together with some other technical documentation, it's only hosted on Swift.org.

For now, your PR on apple/swift-internals is in the right place. I will make sure that we get around to it.

icanzilb · 2022-05-18T09:29:50.562Z

Sweet, thank you! Glad I found the right spot after all