Skip to content
This repository was archived by the owner on May 22, 2026. It is now read-only.

Fix duplicate title warnings by adding version suffixes#471

Draft
Copilot wants to merge 2 commits into
mainfrom
copilot/fix-build-warnings-again
Draft

Fix duplicate title warnings by adding version suffixes#471
Copilot wants to merge 2 commits into
mainfrom
copilot/fix-build-warnings-again

Conversation

Copilot AI commented Feb 4, 2026

Copy link
Copy Markdown

Build validation failing due to duplicate title metadata across GA-version and Public-Preview-Version docs. SEO requires unique titles within a docset.

Changes

Added version suffixes to differentiate titles:

  • 14 GA-version files: Appended - GA to title metadata
  • 2 Public-Preview-Version files: Appended - Public Preview to title metadata

Example

# Before
title: Installation Overview

# After (GA-version)
title: Installation Overview - GA

Files Modified

  • GA-version/get-started/step-by-step-configuration-guide.md
  • GA-version/get-started/user-role-and-management-portal-overview.md
  • GA-version/infrastructure-management/configure-your-platform-infrastructure/Add-multiple-AAD-to-B2C-as-a-social-account.md
  • GA-version/infrastructure-management/configure-your-platform-infrastructure/customize-the-name-and-icon-of-the-training-tab-in-ms-teams.md
  • GA-version/infrastructure-management/install-your-platform-instance/detailed-step-by-step-installation-guide.md
  • GA-version/infrastructure-management/install-your-platform-instance/installation-overview.md
  • GA-version/infrastructure-management/install-your-platform-instance/setup-platform-instance-on-azure-subscription-for-nonprofits.md
  • GA-version/infrastructure-management/monitor-your-platform-infrastructure/reliability-in-community-training.md
  • GA-version/learner-experience/web-app.md
  • GA-version/learning-in-offline-mode/azure-IOT-edge-device-setup.md
  • GA-version/settings/add-additional-profile-fields-for-user-information.md
  • GA-version/settings/configurations-on-the-training-platform.md
  • GA-version/settings/customize-the-certificate-template.md
  • GA-version/settings/link-to-external-website-on-learner-Homepage.md
  • Public-Preview-Version/analytics/custom-reports/power-bi-integration.md
  • Public-Preview-Version/content-management/manage-content/manage-course-category/move-course-content-across-training-instance.md
Original prompt

This section details on the original issue you should resolve

<issue_title>[test] multiple files in a PR</issue_title>
<issue_description>Please fix the following build warnings by following the below guidance.

Severity Type ms.author ms.service ms.subservice ms.topic Code (click link for details) File Message Line, Column Time
Warning User cbrahmandam azure duplicate-titles microsoft-community-training/GA-version/get-started/step-by-step-configuration-guide.md Title 'Step by step configuration guide for platform setup' is duplicated in: 'GA-version/get-started/step-by-step-configuration-guide.md(2,8), Public-Preview-Version/get-started/step-by-step-configuration-guide.md(2,8)'. Titles must be unique within a docset. 2, 8 01/20/2026 11:03:32
Warning User nikotha azure duplicate-titles microsoft-community-training/GA-version/get-started/user-role-and-management-portal-overview.md Title 'User roles and Management portal overview' is duplicated in: 'GA-version/get-started/user-role-and-management-portal-overview.md(2,8), Public-Preview-Version/get-started/user-role-and-management-portal-overview.md(2,8)'. Titles must be unique within a docset. 2, 8 01/20/2026 11:03:32
warning User nikotha azure duplicate-titles microsoft-community-training/GA-version/infrastructure-management/configure-your-platform-infrastructure/Add-multiple-AAD-to-B2C-as-a-social-account.md Title 'Add multiple Azure AD(single tenant) to B2C as social account' is duplicated in: 'GA-version/infrastructure-management/configure-your-platform-infrastructure/Add-multiple-AAD-to-B2C-as-a-social-account.md(2,8), Public-Preview-Version/infrastructure-management/configure-your-platform-infrastructure/Add-multiple-AAD-to-B2C-as-a-social-account.md(2,8)'. Titles must be unique within a docset. 2, 8 01/20/2026 11:03:32
warning User nikotha azure duplicate-titles microsoft-community-training/GA-version/infrastructure-management/configure-your-platform-infrastructure/customize-the-name-and-icon-of-the-training-tab-in-ms-teams.md Title 'Customize the name and icon of the training tab in MS Teams' is duplicated in: 'GA-version/infrastructure-management/configure-your-platform-infrastructure/customize-the-name-and-icon-of-the-training-tab-in-ms-teams.md(2,8), Public-Preview-Version/infrastructure-management/configure-your-platform-infrastructure/customize-the-name-and-icon-of-the-training-tab-in-ms-teams.md(2,8)'. Titles must be unique within a docset. 2, 8 01/20/2026 11:03:32
warning User cbrahmandam azure duplicate-titles microsoft-community-training/GA-version/infrastructure-management/install-your-platform-instance/detailed-step-by-step-installation-guide.md Title 'Detailed step by step installation guide' is duplicated in: 'GA-version/infrastructure-management/install-your-platform-instance/detailed-step-by-step-installation-guide.md(2,8), Public-Preview-Version/infrastructure-management/install-your-platform-instance/detailed-step-by-step-installation-guide.md(2,8)'. Titles must be unique within a docset. 2, 8 01/20/2026 11:03:32
warning User nikotha azure duplicate-titles [microsoft-community-training/GA-version/infrastructure-management/install-your-platform-instance/installation-overview.md](https://github.com/MicrosoftDocs/microsoft-community-training/blob/main/microsoft-community-training/G...

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

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit ce5b9be:

⚠️ Validation status: warnings

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

…ion titles

Co-authored-by: AngryBerryMS <67643974+AngryBerryMS@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix build warnings related to duplicate titles Fix duplicate title warnings by adding version suffixes Feb 4, 2026
Copilot AI requested a review from AngryBerryMS February 4, 2026 06:37
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 84da25a:

⚠️ Validation status: warnings

File Status Preview URL Details
microsoft-community-training/GA-version/get-started/step-by-step-configuration-guide.md ⚠️Warning View Details
microsoft-community-training/GA-version/get-started/user-role-and-management-portal-overview.md ⚠️Warning View Details
microsoft-community-training/GA-version/infrastructure-management/configure-your-platform-infrastructure/Add-multiple-AAD-to-B2C-as-a-social-account.md ⚠️Warning View Details
microsoft-community-training/GA-version/infrastructure-management/configure-your-platform-infrastructure/customize-the-name-and-icon-of-the-training-tab-in-ms-teams.md ⚠️Warning View Details
microsoft-community-training/GA-version/infrastructure-management/install-your-platform-instance/detailed-step-by-step-installation-guide.md ⚠️Warning View Details
microsoft-community-training/GA-version/infrastructure-management/install-your-platform-instance/installation-overview.md ⚠️Warning View Details
microsoft-community-training/GA-version/infrastructure-management/install-your-platform-instance/setup-platform-instance-on-azure-subscription-for-nonprofits.md ⚠️Warning View Details
microsoft-community-training/GA-version/infrastructure-management/monitor-your-platform-infrastructure/reliability-in-community-training.md ⚠️Warning View Details
microsoft-community-training/GA-version/learner-experience/web-app.md ⚠️Warning View Details
microsoft-community-training/GA-version/learning-in-offline-mode/azure-IOT-edge-device-setup.md ⚠️Warning View Details
microsoft-community-training/GA-version/settings/add-additional-profile-fields-for-user-information.md ⚠️Warning View Details
microsoft-community-training/GA-version/settings/configurations-on-the-training-platform.md ⚠️Warning View Details
microsoft-community-training/GA-version/settings/customize-the-certificate-template.md ⚠️Warning View Details
microsoft-community-training/GA-version/settings/link-to-external-website-on-learner-Homepage.md ⚠️Warning View Details
microsoft-community-training/Public-Preview-Version/analytics/custom-reports/power-bi-integration.md ⚠️Warning View Details
microsoft-community-training/Public-Preview-Version/content-management/manage-content/manage-course-category/move-course-content-across-training-instance.md ⚠️Warning View Details

microsoft-community-training/GA-version/get-started/step-by-step-configuration-guide.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 11, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Step-by-step configuration guide for platform setup'.
  • Line 2, Column 1: [Suggestion: ms-date-missing - See documentation] Missing required attribute: 'ms.date'.
  • Line 34, Column 1: [Suggestion: alt-text-bad-value - See documentation] Alt text 'View as admin' is the same as the image file name. This redundancy adds no value for users of screen readers. For accessibility, add more descriptive alt text.
  • Line 61, Column 1: [Suggestion: alt-text-bad-value - See documentation] Alt text 'Upload content to portal' is the same as the image file name. This redundancy adds no value for users of screen readers. For accessibility, add more descriptive alt text.

microsoft-community-training/GA-version/get-started/user-role-and-management-portal-overview.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 11, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'User roles and management portal overview'.
  • Line 2, Column 1: [Suggestion: ms-date-missing - See documentation] Missing required attribute: 'ms.date'.
  • Line 25, Column 1: [Suggestion: alt-text-bad-value - See documentation] Alt text 'GetStarted - Role Hierarchy' is the same as the image file name. This redundancy adds no value for users of screen readers. For accessibility, add more descriptive alt text.

microsoft-community-training/GA-version/infrastructure-management/configure-your-platform-infrastructure/Add-multiple-AAD-to-B2C-as-a-social-account.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 11, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Add multiple Azure AD(single tenant) to B2C as social account'.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Add multiple Azure AD(single tenant) to B2C as social account' is duplicated with other articles: 'GA-version/infrastructure-management/configure-your-platform-infrastructure/Add-multiple-AAD-to-B2C-as-a-social-account.md(11,1), Public-Preview-Version/infrastructure-management/configure-your-platform-infrastructure/Add-multiple-AAD-to-B2C-as-a-social-account.md(10,1)'. First level headings must be unique within a docset.
  • Line 2, Column 1: [Suggestion: ms-date-missing - See documentation] Missing required attribute: 'ms.date'.
  • Line 6, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'Enable sign-in for users from a multiple Azure AD organization using a user flow in Azure AD B2C.' is duplicated in 'GA-version/infrastructure-management/configure-your-platform-infrastructure/Add-multiple-AAD-to-B2C-as-a-social-account.md(6,14)', 'Public-Preview-Version/infrastructure-management/configure-your-platform-infrastructure/Add-multiple-AAD-to-B2C-as-a-social-account.md(6,14)'.

microsoft-community-training/GA-version/infrastructure-management/configure-your-platform-infrastructure/customize-the-name-and-icon-of-the-training-tab-in-ms-teams.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 11, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Customize the name and icon of the training tab in MS Teams'.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Customize the name and icon of the training tab in MS Teams' is duplicated with other articles: 'GA-version/infrastructure-management/configure-your-platform-infrastructure/customize-the-name-and-icon-of-the-training-tab-in-ms-teams.md(11,1), Public-Preview-Version/infrastructure-management/configure-your-platform-infrastructure/customize-the-name-and-icon-of-the-training-tab-in-ms-teams.md(10,1)'. First level headings must be unique within a docset.
  • Line 2, Column 1: [Suggestion: ms-date-missing - See documentation] Missing required attribute: 'ms.date'.
  • Line 6, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'This article assumes you have followed the steps outlined in the MS Teams installation (upto Step 2) and received the Team Manifest file from the Customer Support Team.' is duplicated in 'GA-version/infrastructure-management/configure-your-platform-infrastructure/customize-the-name-and-icon-of-the-training-tab-in-ms-teams.md(6,14)', 'Public-Preview-Version/infrastructure-management/configure-your-platform-infrastructure/customize-the-name-and-icon-of-the-training-tab-in-ms-teams.md(6,14)'.

microsoft-community-training/GA-version/infrastructure-management/install-your-platform-instance/detailed-step-by-step-installation-guide.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 12, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Detailed step by step installation guide'.
  • Line 12, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Detailed step by step installation guide' is duplicated with other articles: 'GA-version/infrastructure-management/install-your-platform-instance/detailed-step-by-step-installation-guide.md(12,1), Public-Preview-Version/infrastructure-management/install-your-platform-instance/detailed-step-by-step-installation-guide.md(10,1)'. First level headings must be unique within a docset.
  • Line 2, Column 1: [Suggestion: ms-date-missing - See documentation] Missing required attribute: 'ms.date'.
  • Line 7, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'In this article, you’ll learn how to install and deploy Microsoft Community Training platform on your Azure subscription.' is duplicated in 'GA-version/infrastructure-management/install-your-platform-instance/detailed-step-by-step-installation-guide.md(7,14)', 'Public-Preview-Version/infrastructure-management/install-your-platform-instance/detailed-step-by-step-installation-guide.md(6,14)'.
  • Line 58, Column 112: [Suggestion: learn-site-link-broken - See documentation] Link 'https://learn.microsoft.com/azure/industry/training-services/microsoft-community-training/infrastructure-management/install-your-platform-instance/configure-login-social-work-school-account?WT.mc_id=Portal-Microsoft_Azure_CommunityTraining#social-account-or-email-based-authentication' points to a learn site page that doesn't exist. Check the path or URL and update the link.

This comment lists only the first 25 errors (including error/warning/suggestion) in the pull request.
For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[test] multiple files in a PR

2 participants