Closed
Description
Summary
The quickstart.md
file contains unnecessarily complex versioning logic in the "Next steps" section that could be simplified for better maintainability and user experience.
Location
- File:
content/copilot/quickstart.md
- Section: Next steps (lines 101-108)
- Problem: 5 product switchers and 12 ifversion conditional blocks across 108 lines
Current problem
The Next steps section uses complex nested versioning with multiple product switchers that create maintenance overhead and potential user confusion.
Current complexity:
- 5 different product environment switchers
- 12 ifversion conditional blocks
- Nested versioning logic across multiple reusable content files
- Inconsistent patterns compared to other quickstart documents
Proposed solution
- Consolidate versioning logic - Reduce the number of product switchers where possible
- Simplify reusable content - Streamline
data/reusables/copilot/quickstart-nextsteps1.md
andquickstart-nextsteps2.md
- Standardize patterns - Align with versioning patterns used in other GitHub Docs quickstart guides
- Improve maintainability - Reduce the cognitive load for future content updates
Additional context
Reference: Identified during PR #38720 review by @Sharra-writes
Related: Part of broader versioning consistency improvement initiative
Code of Conduct
- I agree to follow this project's Code of Conduct