Fix duplicate-titles build warning for MS Teams customization doc#461
Fix duplicate-titles build warning for MS Teams customization doc#461Copilot wants to merge 2 commits into
Conversation
|
Learn Build status updates of commit bca6e53:
|
…n title Co-authored-by: AngryBerryMS <67643974+AngryBerryMS@users.noreply.github.com>
PoliCheck Scan ReportThe 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 foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit d05edf7:
|
Build validation flagged duplicate titles between GA-version and Public-Preview-Version of the MS Teams customization doc.
Changes
(GA)suffix to title metadata and H1 heading inGA-version/.../customize-the-name-and-icon-of-the-training-tab-in-ms-teams.mdPublic-Preview-Version file retains the original title, making both unique within the docset.
Original prompt
This section details on the original issue you should resolve
<issue_title>[test] fix build warnings</issue_title>
<issue_description>Please fix the following build warnings
duplicate-h1s
H1 '{h1-text}' is duplicated with other articles: '{file-path-1}', ...'{file-path-n}'. First level headings must be unique within a docset.Description
For SEO, H1 headings (
#) must be unique within a docset, and ideally should be unique across the site.Resolution
Edit one or more first level heading so all H1s in your docset are unique.
For more information about how to write H1s, see [SEO: Tips for writing a heading 1 (H1)] below.
Optimize main headings (H1s)
This article shares some tips and best practices for optimizing H1s in your Learn content. The H1 is the main heading at the top of a page. It has the second greatest effect on search ranking and the greatest effect on relevance. Like the meta title, the H1 must quickly communicate the intent of the article–what a customer can learn or accomplish with the article.
Why are H1s important?
Search engines perform the complex task of trying to understand the meaning and content of a page. To achieve that, the crawler uses different signals, one of which is the content in the H1. Using your primary keyword in the H1 helps search engines understand the intent of the page and improves rank. H1s also have a significant impact on Copilot responses.
Along with helping search engines understand your content, the H1 also organizes the information on the page, which helps to improve the user experience and accessibility for readers. Increasing the readability of your page keeps users on the page longer.
Don't confuse the H1 with the meta title; they're two different elements. The H1 displays at the top of the article and has a limit of 100 characters including spaces. The meta title is in the article metadata and displays in the browser bar and on the search engine results page.
Rules for writing H1s
Heading examples
Example 1
Original H1: Devices (seven characters)
Edited H1: Overview of device APIs for Windows desktop app technologies (60 characters)
The original H1 is vague and overlaps with other Win32 pages. The updated H1 is much more informative and specific to the page, which ultimately helps search engines rank the content more effectively. One word is unlikely to ever be enough to describe the intent of a page. Add detail to sparse or short H1 text.
Example 2
Original H1: Getting started (15 characters)
Edited H1: Get sta...
💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.