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

Add missing ms.date attribute to markdown files#460

Draft
Copilot wants to merge 3 commits into
mainfrom
copilot/fix-ms-data-missing
Draft

Add missing ms.date attribute to markdown files#460
Copilot wants to merge 3 commits into
mainfrom
copilot/fix-ms-data-missing

Conversation

Copy link
Copy Markdown

Copilot AI commented Feb 2, 2026

Build validation flagged 6 markdown files missing the required ms.date frontmatter attribute for content freshness tracking.

Changes

Added ms.date: 01/20/2026 to YAML frontmatter in:

  • GA-version/analytics/in-built-reports/category-view-report.md
  • GA-version/analytics/in-built-reports/course-view-report.md
  • GA-version/analytics/in-built-reports/group-view-report.md
  • GA-version/analytics/in-built-reports/learner-report-card-view.md
  • GA-version/analytics/in-built-reports/overall-summary.md
  • GA-version/content-management/content-management-overview.md

The date used (01/20/2026) is the date these articles were last updated in the main branch.

Example

---
title: Category View
author: nikotha
ms.author: nikotha
ms.service: azure
ms.date: 01/20/2026
---
Original prompt

This section details on the original issue you should resolve

<issue_title>[test] fix ms-data-missing</issue_title>
<issue_description>Please fix the following build warnings

Severity Type ms.author ms.service ms.subservice ms.topic Code (click link for details) File Message Line, Column Time
Suggestion User nikotha azure ms-date-missing microsoft-community-training/GA-version/analytics/in-built-reports/category-view-report.md Missing required attribute: 'ms.date'. 2, 1 01/20/2026 11:03:31
Suggestion User nikotha azure ms-date-missing microsoft-community-training/GA-version/analytics/in-built-reports/course-view-report.md Missing required attribute: 'ms.date'. 2, 1 01/20/2026 11:03:30
Suggestion User nikotha azure ms-date-missing microsoft-community-training/GA-version/analytics/in-built-reports/group-view-report.md Missing required attribute: 'ms.date'. 2, 1 01/20/2026 11:03:29
Suggestion User nikotha azure ms-date-missing microsoft-community-training/GA-version/analytics/in-built-reports/learner-report-card-view.md Missing required attribute: 'ms.date'. 2, 1 01/20/2026 11:03:29
Suggestion User nikotha azure ms-date-missing microsoft-community-training/GA-version/analytics/in-built-reports/overall-summary.md Missing required attribute: 'ms.date'. 2, 1 01/20/2026 11:03:29
Suggestion User nikotha azure ms-date-missing microsoft-community-training/GA-version/content-management/content-management-overview.md Missing required attribute: 'ms.date'. 2, 1 01/20/2026 11:03:31

ms-date-missing

Missing attribute: ms.date. A freshness date is required for this content. Add a date in format MM/DD/YYYY.

Description

Some content groups require ms.date to indicate "freshness" - that is, when the article was last reviewed for relevance, accuracy, correct screenshots, and working links. Freshness isn't the same as the last date the article was published, which will show on the page if ms.date isn't explicitly specified. We can consider to use the date that this article is updated in main branch.

Resolution

Confirm that the article is up to date with no broken content, then add a valid date in the format MM/DD/YYYY:

YAML

---
ms.date: 02/19/2019
---
```</issue_description>

## Comments on the Issue (you are @copilot in this section)

<comments>
</comments>


✨ 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 2e8e5b0:

⚠️ 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.

…d warnings

Co-authored-by: AngryBerryMS <67643974+AngryBerryMS@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix ms.date attribute warnings in documentation Add missing ms.date attribute to markdown files Feb 2, 2026
Copilot AI requested a review from AngryBerryMS February 2, 2026 08:36
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit decfab6:

⚠️ Validation status: warnings

File Status Preview URL Details
microsoft-community-training/GA-version/analytics/in-built-reports/category-view-report.md ⚠️Warning View Details
microsoft-community-training/GA-version/analytics/in-built-reports/course-view-report.md ⚠️Warning View Details
microsoft-community-training/GA-version/analytics/in-built-reports/group-view-report.md ⚠️Warning View Details
microsoft-community-training/GA-version/analytics/in-built-reports/learner-report-card-view.md ⚠️Warning View Details
microsoft-community-training/GA-version/analytics/in-built-reports/overall-summary.md ⚠️Warning View Details
microsoft-community-training/GA-version/content-management/content-management-overview.md ⚠️Warning View Details

microsoft-community-training/GA-version/analytics/in-built-reports/category-view-report.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 'Category View'.

microsoft-community-training/GA-version/analytics/in-built-reports/course-view-report.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 'Course View'.

microsoft-community-training/GA-version/analytics/in-built-reports/group-view-report.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Group view' is duplicated in: 'GA-version/analytics/in-built-reports/group-view-report.md(2,8), Public-Preview-Version/analytics/in-built-reports/group-view-report.md(2,8)'. Titles must be unique within a docset.
  • Line 12, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Group View'.
  • Line 6, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'Group admin are responsible to drive engagement and monitor course completion for learners on the ground.' is duplicated in 'GA-version/analytics/in-built-reports/group-view-report.md(6,14)', 'Public-Preview-Version/analytics/in-built-reports/group-view-report.md(6,14)'.

microsoft-community-training/GA-version/analytics/in-built-reports/learner-report-card-view.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Learner Report Card View' is duplicated in: 'GA-version/analytics/in-built-reports/learner-report-card-view.md(2,8), Public-Preview-Version/analytics/in-built-reports/learner-report-card-view.md(2,8)'. Titles must be unique within a docset.
  • Line 12, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Learner Report Card View'.
  • Line 12, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Learner Report Card View' is duplicated with other articles: 'GA-version/analytics/in-built-reports/learner-report-card-view.md(12,1), Public-Preview-Version/analytics/in-built-reports/learner-report-card-view.md(10,1)'. First level headings must be unique within a docset.

microsoft-community-training/GA-version/analytics/in-built-reports/overall-summary.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Overall summary view' is duplicated in: 'GA-version/analytics/in-built-reports/overall-summary.md(2,8), Public-Preview-Version/analytics/in-built-reports/overall-summary.md(2,8)'. Titles must be unique within a docset.
  • Line 12, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Overall summary view'.
  • Line 12, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Overall summary view' is duplicated with other articles: 'GA-version/analytics/in-built-reports/overall-summary.md(12,1), Public-Preview-Version/analytics/in-built-reports/overall-summary.md(10,1)'. First level headings must be unique within a docset.
  • Line 6, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'Overall summary view is designed to give the admin a quick glance at the learner enrollments, learner engagement and course completion.' is duplicated in 'GA-version/analytics/in-built-reports/overall-summary.md(6,14)', 'Public-Preview-Version/analytics/in-built-reports/overall-summary.md(6,14)'.

microsoft-community-training/GA-version/content-management/content-management-overview.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Content Management - Overview' is duplicated in: 'GA-version/content-management/content-management-overview.md(2,8), Public-Preview-Version/content-management/content-management-overview.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Content Management - Overview' is duplicated with other articles: 'GA-version/content-management/content-management-overview.md(11,1), Public-Preview-Version/content-management/content-management-overview.md(10,1)'. First level headings must be unique within a docset.
  • Line 25, Column 1: [Suggestion: alt-text-bad-value - See documentation] Alt text 'Course Management - Course and Category' 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 98, Column 1: [Suggestion: alt-text-bad-value - See documentation] Alt text 'Course Management - Learning path' 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 162, Column 1: [Suggestion: alt-text-bad-value - See documentation] Alt text 'Track analytics' 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.

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.

@AngryBerryMS
Copy link
Copy Markdown
Member

@copilot We can consider to use the date that this article is updated in main branch. not the date of today

…f current date

Co-authored-by: AngryBerryMS <67643974+AngryBerryMS@users.noreply.github.com>
Copy link
Copy Markdown
Author

Copilot AI commented Feb 2, 2026

@copilot We can consider to use the date that this article is updated in main branch. not the date of today

Updated the ms.date to 01/20/2026 for all 6 files, which is the date these articles were last updated in the main branch. (5509242)

@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.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 5509242:

⚠️ Validation status: warnings

File Status Preview URL Details
microsoft-community-training/GA-version/analytics/in-built-reports/category-view-report.md ⚠️Warning View Details
microsoft-community-training/GA-version/analytics/in-built-reports/course-view-report.md ⚠️Warning View Details
microsoft-community-training/GA-version/analytics/in-built-reports/group-view-report.md ⚠️Warning View Details
microsoft-community-training/GA-version/analytics/in-built-reports/learner-report-card-view.md ⚠️Warning View Details
microsoft-community-training/GA-version/analytics/in-built-reports/overall-summary.md ⚠️Warning View Details
microsoft-community-training/GA-version/content-management/content-management-overview.md ⚠️Warning View Details

microsoft-community-training/GA-version/analytics/in-built-reports/category-view-report.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 'Category View'.

microsoft-community-training/GA-version/analytics/in-built-reports/course-view-report.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 'Course View'.

microsoft-community-training/GA-version/analytics/in-built-reports/group-view-report.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Group view' is duplicated in: 'GA-version/analytics/in-built-reports/group-view-report.md(2,8), Public-Preview-Version/analytics/in-built-reports/group-view-report.md(2,8)'. Titles must be unique within a docset.
  • Line 12, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Group View'.
  • Line 6, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'Group admin are responsible to drive engagement and monitor course completion for learners on the ground.' is duplicated in 'GA-version/analytics/in-built-reports/group-view-report.md(6,14)', 'Public-Preview-Version/analytics/in-built-reports/group-view-report.md(6,14)'.

microsoft-community-training/GA-version/analytics/in-built-reports/learner-report-card-view.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Learner Report Card View' is duplicated in: 'GA-version/analytics/in-built-reports/learner-report-card-view.md(2,8), Public-Preview-Version/analytics/in-built-reports/learner-report-card-view.md(2,8)'. Titles must be unique within a docset.
  • Line 12, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Learner Report Card View'.
  • Line 12, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Learner Report Card View' is duplicated with other articles: 'GA-version/analytics/in-built-reports/learner-report-card-view.md(12,1), Public-Preview-Version/analytics/in-built-reports/learner-report-card-view.md(10,1)'. First level headings must be unique within a docset.

microsoft-community-training/GA-version/analytics/in-built-reports/overall-summary.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Overall summary view' is duplicated in: 'GA-version/analytics/in-built-reports/overall-summary.md(2,8), Public-Preview-Version/analytics/in-built-reports/overall-summary.md(2,8)'. Titles must be unique within a docset.
  • Line 12, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Overall summary view'.
  • Line 12, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Overall summary view' is duplicated with other articles: 'GA-version/analytics/in-built-reports/overall-summary.md(12,1), Public-Preview-Version/analytics/in-built-reports/overall-summary.md(10,1)'. First level headings must be unique within a docset.
  • Line 6, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'Overall summary view is designed to give the admin a quick glance at the learner enrollments, learner engagement and course completion.' is duplicated in 'GA-version/analytics/in-built-reports/overall-summary.md(6,14)', 'Public-Preview-Version/analytics/in-built-reports/overall-summary.md(6,14)'.

microsoft-community-training/GA-version/content-management/content-management-overview.md

  • Line 2, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Content Management - Overview' is duplicated in: 'GA-version/content-management/content-management-overview.md(2,8), Public-Preview-Version/content-management/content-management-overview.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Content Management - Overview' is duplicated with other articles: 'GA-version/content-management/content-management-overview.md(11,1), Public-Preview-Version/content-management/content-management-overview.md(10,1)'. First level headings must be unique within a docset.
  • Line 25, Column 1: [Suggestion: alt-text-bad-value - See documentation] Alt text 'Course Management - Course and Category' 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 98, Column 1: [Suggestion: alt-text-bad-value - See documentation] Alt text 'Course Management - Learning path' 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 162, Column 1: [Suggestion: alt-text-bad-value - See documentation] Alt text 'Track analytics' 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.

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.

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] fix ms-data-missing

2 participants