Skip to content

best practice template for ESG#34

Draft
heckj wants to merge 3 commits intoswiftlang:mainfrom
heckj:practice-template
Draft

best practice template for ESG#34
heckj wants to merge 3 commits intoswiftlang:mainfrom
heckj:practice-template

Conversation

@heckj
Copy link
Copy Markdown
Member

@heckj heckj commented Feb 26, 2026

Summary

Provides a template for the Ecosystems Steering Group to utilize for providing guidance when using Swift.

Type of Change

  • Content error fix (corrects inaccurate information)
  • Enhancement (improves existing content)
  • New content (adds new documentation)
  • Technical change (build system, tooling, infrastructure)
  • Typo or formatting fix

Documentation Package(s) Affected

  • API Guidelines
  • Language Guides
  • Server Guides
  • Ecosystem Tools
  • Repository infrastructure

Changes Made

DocC Markdown template file for a best practice guide/article.

Technical Review Required

  • Technical review completed by appropriate CODEOWNERS

Additional Notes


By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

@heckj
Copy link
Copy Markdown
Member Author

heckj commented Feb 26, 2026

/cc @FranzBusch - leaving this in draft state at the moment, can easily adjust to whatever the ESG prefers to use here.

@heckj heckj changed the title initial stub of a best practice template for ESG best practice template for ESG Feb 26, 2026
@heckj heckj added the content proposal Proposal for new content label Mar 3, 2026
@heckj heckj force-pushed the practice-template branch from 03c763e to 690c644 Compare March 13, 2026 17:51
…the template provided. Adds structure to host best practices in the future
@heckj
Copy link
Copy Markdown
Member Author

heckj commented Mar 13, 2026

@FranzBusch I added a "how to create an article" to match the template, and added a placeholder that would easily house future best practices. I didn't put in anything about how the articles are reviewed or vetted, but happy to help write up something with the ESG if the group has a process they'd like to have documented.

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

Labels

content proposal Proposal for new content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants