Skip to content

Introduce SV-NNNN numbering convention for vision documents#3359

Open
stmontgomery wants to merge 1 commit into
swiftlang:mainfrom
stmontgomery:vision-ids
Open

Introduce SV-NNNN numbering convention for vision documents#3359
stmontgomery wants to merge 1 commit into
swiftlang:mainfrom
stmontgomery:vision-ids

Conversation

@stmontgomery

@stmontgomery stmontgomery commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

This introduces 4-digit ID prefixes of the form SV-NNNN for vision documents, to retroactively number them matching the convention used by proposals (in the proposals/ directory).

Since there are likely many existing links pointing to the unversioned filenames, the original files are left in place; each new versioned file just carries the title, its new ID, and a note redirecting to the original.

I chose the ID numbers based on the date each vision document was first added to the repo:

ID Filename Creation Date
0001 using-swift-from-c++.md Dec 16, 2022
0002 macros.md Mar 22, 2023
0003 using-c++-from-swift.md May 22, 2023
0004 embedded-swift.md Oct 25, 2023
0005 webassembly.md Mar 9, 2024
0006 swift-testing.md May 22, 2024
0007 memory-safety.md Oct 1, 2024
0008 approachable-concurrency.md Feb 18, 2025
0009 networking.md Mar 6, 2026

I also added a description of the new document formatting details to the process documentation.

Thank you to @ktoso for suggesting this!

Introduces 4-digit ID prefixes for vision documents, matching the
convention used by proposals/. Since existing GitHub links point to the
unversioned filenames, the original files are left in place; each new
file just carries the title and a note redirecting to the original.
@stmontgomery stmontgomery self-assigned this Jul 15, 2026
@stmontgomery stmontgomery added evolution process A change to the meta-content of evolution, e.g. the process documentation or templates vision Prospective vision document editorial Editorial change to an existing document formatting Changes to content formatting ESG Contains topics under the domain of the Ecosystem Steering Group labels Jul 15, 2026

@FranzBusch FranzBusch left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for raising the PR. Will discuss it in the next ESG meeting.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

editorial Editorial change to an existing document ESG Contains topics under the domain of the Ecosystem Steering Group evolution process A change to the meta-content of evolution, e.g. the process documentation or templates formatting Changes to content formatting vision Prospective vision document

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants