Skip to content

Update the How To Use Docs page for freshness#12711

Merged
sdwheeler merged 3 commits intoMicrosoftDocs:mainfrom
sdwheeler:sdw-w548360-how-to-use-docs
Jan 29, 2026
Merged

Update the How To Use Docs page for freshness#12711
sdwheeler merged 3 commits intoMicrosoftDocs:mainfrom
sdwheeler:sdw-w548360-how-to-use-docs

Conversation

@sdwheeler
Copy link
Copy Markdown
Collaborator

@sdwheeler sdwheeler commented Jan 28, 2026

PR Summary

Update the How To Use Docs page for freshness

PR Checklist

  • Descriptive Title: This PR's title is a synopsis of the changes it proposes.
  • Summary: This PR's summary describes the scope and intent of the change.
  • Contributor's Guide: I have read the contributor's guide.
  • Style: This PR adheres to the style guide.

Copilot AI review requested due to automatic review settings January 28, 2026 23:25
@sdwheeler sdwheeler force-pushed the sdw-w548360-how-to-use-docs branch from 49f8d2a to d444f36 Compare January 28, 2026 23:26
@learn-build-service-prod

This comment was marked as outdated.

1 similar comment
@learn-build-service-prod

This comment was marked as outdated.

Copy link
Copy Markdown
Contributor

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 updates the "How to Use the PowerShell Documentation" page to reflect current features and UI changes, along with metadata updates for content freshness tracking.

Changes:

  • Updated documentation content to describe current features like the "Ask Learn" button, "Focus mode" button, and improved navigation descriptions
  • Replaced animated GIF images with static PNG screenshots for the PDF button and Previous Versions selector
  • Added ms.update-cycle metadata to track content freshness (365-day default for most content, 3650-day for DSC overview)

Reviewed changes

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

Show a summary per file
File Description
reference/docs-conceptual/how-to-use-docs.md Main content update with corrected descriptions, reorganized sections, and updated version information (removed "RC" designation from PowerShell 7.5)
reference/docs-conceptual/media/how-to-use-docs/pdf-button.png New static PNG image replacing the animated GIF
reference/docs-conceptual/media/how-to-use-docs/previous-versions.png New static PNG image replacing the animated GIF
reference/docs-conceptual/dsc/overview.md Added ms.update-cycle metadata (3650-days)
reference/docfx.json Added default ms.update-cycle metadata value (365-days) for all content

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread reference/docs-conceptual/how-to-use-docs.md Outdated
Comment thread reference/docs-conceptual/how-to-use-docs.md Outdated
@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@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 661578e:

✅ Validation status: passed

File Status Preview URL Details
reference/docfx.json ✅Succeeded
reference/docs-conceptual/dsc/overview.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/how-to-use-docs.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/media/how-to-use-docs/how-to-use.gif ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/media/how-to-use-docs/pdf-button.gif ✅Succeeded n/a (file deleted or renamed)
reference/docs-conceptual/media/how-to-use-docs/pdf-button.png ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/media/how-to-use-docs/previous-versions.gif ✅Succeeded n/a (file deleted or renamed)
reference/docs-conceptual/media/how-to-use-docs/previous-versions.png ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/media/how-to-use-docs/search-scope.gif ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/media/how-to-use-docs/version-search.gif ✅Succeeded View (>=powershell-5.1)

For more details, please refer to the build report.

@sdwheeler sdwheeler merged commit 843a9ed into MicrosoftDocs:main Jan 29, 2026
5 checks passed
@sdwheeler sdwheeler deleted the sdw-w548360-how-to-use-docs branch February 2, 2026 21:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants