Skip to content

Content improvement: Simplify versioning complexity in quickstart.md Next steps section #38825

Closed
@aymanaboghonim

Description

@aymanaboghonim

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

  1. Consolidate versioning logic - Reduce the number of product switchers where possible
  2. Simplify reusable content - Streamline data/reusables/copilot/quickstart-nextsteps1.md and quickstart-nextsteps2.md
  3. Standardize patterns - Align with versioning patterns used in other GitHub Docs quickstart guides
  4. 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    contentThis issue or pull request belongs to the Docs Content teamcopilotContent related to GitHub Copilothelp wantedAnyone is welcome to open a pull request to fix this issue

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions