Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Aug 21, 2025

The AI configuration documentation for FinOps hubs contained broken download links that prevented users from accessing the GitHub Copilot instructions. The issue occurred because:

  1. Documentation links pointed to finops-hub-copilot.zip (unversioned filename)
  2. Recent releases (v12+) only contained finops-hub-copilot-v12.zip (versioned filename)
  3. GitHub's /releases/latest/download/ redirect failed due to filename mismatch

This resulted in 404 errors when users tried to download the AI instructions from the Configure AI documentation.

Solution

Modified the packaging script (Package-Toolkit.ps1) to create both versioned and unversioned ZIP files specifically for the finops-hub-copilot template:

  • finops-hub-copilot-v12.0.zip (versioned, maintains consistency with other templates)
  • finops-hub-copilot.zip (unversioned, enables stable documentation links)

The fix is minimal and surgical - only the finops-hub-copilot template receives this special handling. Other templates continue to use versioned filenames only, maintaining the existing release structure.

Testing

  • ✅ Build and package processes work correctly
  • ✅ Both files are created with identical contents
  • ✅ No impact on other templates
  • ✅ Documentation links will work in future releases

Fixes #1803.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@Copilot Copilot AI changed the title [WIP] FinOps hub configure AI has a broken link for AI instructions Fix broken finops-hub-copilot.zip download link in AI configuration docs Aug 21, 2025
Copilot finished work on behalf of flanakin August 21, 2025 15:53
Compress-Archive -Path "$srcPath/*" -DestinationPath $zip

# Create unversioned copy for specific templates that need stable download links
if ($templateName -eq "finops-hub-copilot")
Copy link
Collaborator

Choose a reason for hiding this comment

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

We should not use one-off logic here. We should be consistent. Also this will break a test so that would also need to be updated.

@microsoft-github-policy-service microsoft-github-policy-service bot added Needs: Attention 👋 Issue or PR needs to be reviewed by the author or it will be closed due to no activity and removed Needs: Review 👀 PR that is ready to be reviewed labels Aug 31, 2025

@@copilot: you have some new feedback!

Please review and resolve all comments and I'll let reviewers know by removing the Needs: Attention label. If I miss anything, just reply with #needs-review and I'll update the status.

@MSBrett MSBrett requested a review from Copilot September 10, 2025 15:18
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR fixes broken download links for GitHub Copilot instructions in the FinOps hubs AI configuration documentation. The issue occurred because documentation links used unversioned filenames (finops-hub-copilot.zip) while recent releases only included versioned filenames (finops-hub-copilot-v12.zip), causing 404 errors.

  • Modified the packaging script to create both versioned and unversioned ZIP files for the finops-hub-copilot template
  • Updated the changelog to document this fix

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
src/scripts/Package-Toolkit.ps1 Added logic to create unversioned copy of finops-hub-copilot.zip alongside the versioned file
docs-mslearn/toolkit/changelog.md Added changelog entry documenting the fix for GitHub Copilot instructions download link

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

Labels

Needs: Attention 👋 Issue or PR needs to be reviewed by the author or it will be closed due to no activity Skill: DevOps GitHub setup and automation Skill: Documentation Documentation updates Tool: FinOps guide Implementing FinOps guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

FinOps hub configure AI has a broken link for AI instructions

4 participants