Mixing Swift and C++

Source: documentation/cxx-interop/index.md
Proposed disposition: Needs determination — defer to C++ interop team
Proposed destination: Unknown; possibly a cxx-interop catalog in the Swift compiler repository, or language-guides/LanguageGuides.docc
Reviewer: @swiftlang/language-steering-group

Checklist

• Create a GitHub issue to track this migration once destination is confirmed
• Determine disposition and choose explicit destination (coordinate with Doug Gregor and the C++ interop team)
• Review source for accuracy against the current Swift C++ interop feature set
• Translate Jekyll markdown to DocC markdown format
  • Remove YAML front matter
  • Convert any Jekyll callouts to DocC-style callouts
  • Verify all interop examples compile under current toolchain
• Add article to target catalog's Documentation.md
• Run swift package generate-documentation --analyze --warnings-as-errors in the target package
• Preview locally with swift package --disable-sandbox preview-documentation
• Submit PR for appropriate team review
• After merge and publication: add redirect_to: in the swift.org source file's front matter
• Submit redirect PR to swift-org-website

Start with documentation/cxx-interop/index.md, then determine the catalog destination with the C++ interop team and language steering group. Review the article against the current Swift C++ interop feature set, convert it to DocC format, and verify the examples with the target package's documentation commands. Done means the destination is selected, the article is published with a source redirect, and the redirect PR is submitted to swift-org-website.