Skip to content

Commit cf867d9

Browse files
chore(repo): sync from inner source
Sync from github/github-well-architected-internal (main) Source Repository: github/github-well-architected-internal Source Branch: main Source SHA: 305071ee8bc9ffd73431899324b78c91705517b9 Co-authored-by: well-architected-sync-bot[bot] <235114805+well-architected-sync-bot[bot]@users.noreply.github.com>
1 parent 37d788b commit cf867d9

8 files changed

Lines changed: 87 additions & 56 deletions

File tree

content/library/overview/release-notes.md

Lines changed: 0 additions & 56 deletions
This file was deleted.
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
<!-- markdownlint-disable MD041 -->
2+
3+
## 2024 Q4
4+
5+
- **General Availability (GA) and Well-Architected MVP Launch** - Transitioned from beta to GA with a fully published structure around the five pillars, including curated examples and illustrations that demonstrate practical implementations
6+
- **Initial Tooling & Assessment Checklists** - Provided downloadable checklists for customers to self-assess alignment with the framework and gathered early adoption feedback to inform Checklists 2.0
7+
- **Design Principles and Content Highlights** - Published an in-depth overview of the five pillars (Productivity, Collaboration, Application Security, Governance, and Architecture), co-authored an initial set of design principles with KPMG and our Partner Community, and added a high-level scenario for teams starting with GitHub Enterprise
8+
- **Early Feedback Incorporations** - Streamlined site layouts and navigation based on beta feedback, and expanded scenario guidance including scaling Git repositories and enforcing GHAS at scale
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
<!-- markdownlint-disable MD041 -->
2+
3+
## 2025 Q1
4+
5+
- **New Content: GitHub Actions Scalability** - Published guidance for scaling GitHub Actions reusability in enterprise environments, including best practices for workflow optimization, action management, and enterprise-wide deployment
6+
- **New Content: Repository Migration Essentials** - Introduced a generalized repository migration checklist covering pre-planning, testing, execution, and post-migration, designed to serve as a single source of truth across migration approaches
7+
- **Design Principle Updates** - Expanded real-world examples across pillars, including clearer guidance on pull request best practices, early vulnerability scanning, and multi-region deployment considerations
8+
- **Checklists 2.0** - Overhauled the assessment checklists to align with recent GitHub product updates and introduced tiers to help teams prioritize actions based on maturity
9+
- **Fixes & Refinements** - Improved clarity and usability with refinements to pillar content, navigation, homepage layout, and the hosting template for simpler ongoing maintenance
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<!-- markdownlint-disable MD041 -->
2+
3+
## 2025 Q2
4+
5+
- **New Content: Azure DevOps Migration Guide** - Published migration scenarios and playbooks for transitioning from Azure DevOps to GitHub, including phased approaches, feature comparisons, and practical guidance for translating Azure DevOps settings to GitHub equivalents
6+
- **New Content: Engineering System Success Framework** - Published the Engineering System Success Framework to help organizations evaluate Copilot business value, including design principles, checklists, metrics, implementation phases, anti-patterns, and intervention strategies
7+
- **Site Improvements** - Introduced a new Copilot Chat Widget that provides interactive assistance for users
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
<!-- markdownlint-disable MD041 -->
2+
3+
## 2025 Q3
4+
5+
- **Update: Repository Management Enhancement** - Updated the "Managing repositories at scale" article with opinionated guidance on adopting rulesets and custom properties to meet business objectives, including actionable strategies for governance at scale
6+
- **Update: GitHub Actions Policy Updates** - Updated the GitHub Actions recommendations with new policy capabilities and more prescriptive governance and security guidance for managing workflows at scale
7+
- **New Content: GitHub Copilot Enterprise Administration** - Published an enterprise playbook for managing GitHub Copilot Premium Request Units (PRUs), including budget configuration, KPI targets, monitoring, and cost control strategies
8+
- **New Content: Security Alert Management** - Published a scenario for prioritizing security alert remediation using GitHub's built-in metadata and organizational context, including practical guidance on implementing GitHub's security campaigns and vulnerability triage workflows
9+
- **New Content: Champion Program** - Published a recommendation for champion programs that empower engaged employees to guide peers through AI-driven change.
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<!-- markdownlint-disable MD041 -->
2+
3+
## 2025 Q4
4+
5+
- **New Content: Actions Runner Controller (ARC) best practices** - Published an opinionated guidance for operating ARC on Kubernetes, including recommendations for runner images, configuration, observability, and security trade-offs
6+
- **New Content: Securing developer workspace** - Published an design guidance for hardening developer workspaces, including identity and authorization, workspace isolation, and signed commit practices
7+
- **Update: Securing GitHub Actions workflows** - Added opinionated guidance for OIDC, repository rulesets, and safer workflow patterns, with specific recommendations for public repository security
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
---
2+
# SPDX-FileCopyrightText: GitHub and The Project Authors
3+
# SPDX-License-Identifier: MIT
4+
title: Release notes
5+
weight: 4
6+
prev: library/overview/getting-started-checklist
7+
next: library/scenarios
8+
---
9+
10+
Find general updates here on new content, feature enhancements, and improvements that help teams architect and optimize deployments of the tools that support their development communities.
11+
12+
{{% quarterly-updates %}}
13+
14+
## Future Plans & Roadmap
15+
16+
- **Partner & Ecosystem Growth**: Ongoing partner showcases, workshops, and contributions will introduce new specialized assessment offerings
17+
- **Deeper AI Integration**: Expanding GitHub Copilot insights and AI-based recommendations to cover governance, security, and productivity checks
18+
- **Advanced Scenarios & Recommendations**: Adding guides on large-scale workflows, compliance-first deployments, and hybrid architectures
19+
- **Continuous Feedback**: Regularly soliciting community input through partner channels and real-world customer engagements to shape new content
20+
21+
We're committed to continuous improvement of GitHub Well-Architected. If you have questions or feedback, please reach out to your Partner or our GitHub Support and Services teams.
22+
23+
Thank you for your interest in building resilient, scalable development practices!
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
{{- /*
2+
Shortcode: quarterly-updates
3+
4+
Auto-renders quarterly release notes section files from the current page bundle.
5+
6+
Convention:
7+
- Quarterly section resources are named like "YYYY-qN.md" (for example, "2025-q4.md").
8+
- Sorting is based on filename (descending).
9+
- Files must use markdown headings (##) for TOC compatibility.
10+
11+
Usage:
12+
{{% quarterly-updates %}}
13+
14+
Note: Use percent delimiters (%) instead of angle brackets (<) so headings appear in TOC.
15+
*/ -}}
16+
17+
{{- $sections := .Page.Resources.Match "20*-q*.md" -}}
18+
{{- if not $sections -}}
19+
{{- errorf "quarterly-updates: no matching section files found for %q" .Page.File.Path -}}
20+
{{- end -}}
21+
22+
{{- range (sort $sections "Name" "desc") -}}
23+
{{- .RenderShortcodes -}}
24+
{{- end -}}

0 commit comments

Comments
 (0)