Skip to content

Include Swift platform support within the public documentation for Swift #1123

@heckj

Description

@heckj

Is your feature request related to a problem? Please describe

The Platform Steering Group (PSG) recently posted a vision for platform support from Swift into the Swift Forums, the core content of which is stored in a vision document in the swift evolution repository.

This detail, and what is currently available as tier 1 and tier 2 should be available as public documentation for Swift, likely available through the swift.org website. In discussing with the PSG, Saleem highlighted two audience focused use cases that captured the needs nicely:

  1. a high level - does this work for the platform I'm interested in - sort of query/question, where someone potentially new to swift is just trying to understand if the language is (or can be) relevant for what they're after. In short - "only the high level, please"

  2. a down-in-the-weeds platform developer that wants to find out and understand the details that are associated with a platform, implementation specifics, or finding out who they could communicate with to learn more about an existing SDK to be able to solve a specific problem they're encountering. In short - the "gory details, please"

Describe the solution you'd like

  • Identify where the information can live in the swift.org website, with the content being easily-enough findable for the high level use case, and details linked or available for the "gory details" use case.
  • Establish initial pages with the technical accuracy reviewed by the PSG, including:
    • a list of the tiers and currently support platforms
    • Tier 1
      • Apple platforms
      • Linux
      • Windows
  • Tier 2
    • ??

Describe alternatives you've considered

Additional context

The "gory details" pages should include - per platform support - provenance information to validate the SDK, a Software Bill of Materials (SBOM), and possibly more information that would be relevant to debugging and understand specifics of platform details.

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions