Skip to content

Add Classic Page Assessment and transformation handoff guidance - #10961

Merged
Bert Jansen (jansenbe) merged 15 commits into
SharePoint:mainfrom
TaoziZ03:titao/assessment-docs-stage1
Jul 27, 2026
Merged

Add Classic Page Assessment and transformation handoff guidance#10961
Bert Jansen (jansenbe) merged 15 commits into
SharePoint:mainfrom
TaoziZ03:titao/assessment-docs-stage1

Conversation

@TaoziZ03

@TaoziZ03 TaoziZ03 commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add a first-party Microsoft Learn entry point for assessing classic SharePoint pages and handing selected pages off to PnP PowerShell transformation.
  • Document Classic Pages requirements, application-certificate setup, assessment execution, coverage validation, report interpretation, and publishing-page readiness.
  • Map Assessment CSV page identity fields to Connect-PnPOnline and ConvertTo-PnPPage.
  • Organize the TOC as an ordered task workflow, with page-specific and common CSV schemas grouped under Reference.

Scope

This PR covers Classic Page Assessment and its handoff to the existing Page Transformation guidance.

It intentionally does not cover Lists, broad Extensibility, InfoPath, AddInsACS, Alerts, an all-up modernization tool comparison, the Page Transformation documentation rewrite, or Scanner archival.

Page modernization workflow

The new guidance directs readers to:

  1. Configure and run the Classic Pages assessment.
  2. Validate site, web, and Audit coverage.
  3. Interpret and prioritize page results.
  4. Remediate or map blocking Web Parts.
  5. Transform selected pages with PnP PowerShell.
  6. Validate the generated modern pages before expanding the migration wave.

The report guidance maps SiteUrl, WebUrl, ListUrl, PageUrl, PageName, and PageType to the source connection and transformation parameters. Publishing, Blog, ASPX, and Delve Blog rows have explicit routing or exclusion guidance.

Permission and Audit validation

Assessment 1.16 was validated against isolated tenant scopes.

Authentication Microsoft Graph SharePoint Result
Application Sites.Read.All application Sites.Read.All application Full-tenant Pages completed for 6/6 site collections
Interactive Sites.Read.All, User.Read delegated AllSites.Read delegated Selected-site Pages completed

Read-only and Sites.FullControl.All Pages runs produced identical page, Web Part, and mapping output.

Audit validation confirmed:

  • Missing AuditLogsQuery-SharePoint.Read.All produces QueryStatus=failed with SkipReason=NoPermission.
  • Application and Device permission paths can submit Microsoft Graph Audit queries.
  • A query accepted by the backend can still end as QueryTimeout after Assessment's 90-minute wait.
  • The guidance distinguishes permission, Purview provisioning, and query-worker timeout states.

End-to-end documentation dogfood

An independent cold-start run followed only these documents, their direct links, and built-in command help:

  • Assessment scanned one root site collection in four minutes: 1/1 site and web completed, with 423 classic pages and no scan failures.
  • A five-page representative wave was selected only from Assessment CSV output.
  • Three Wiki pages transformed successfully and preserved the expected visible content.
  • One page reported as 100-percent mapped failed safely during ContactFieldControl transformation; no target page remained.
  • One Web Part page reported WebPartCount=0 and MappingPercentage=100 but produced a blank migrated page, demonstrating why validation is required.
  • No source page was renamed, overwritten, deleted, unpublished, or otherwise modified, and the run did not expand beyond the representative wave.

This confirms that mapping percentage is a planning signal, not a guarantee of transformation or content parity.

Validation

  • OpenPublishing build, PoliCheck, and CLA checks pass at the current head.
  • Classic Pages CLI and CSV contracts were checked against Assessment 1.16.
  • Application and Interactive read-permission profiles were exercised on live tenants.
  • PnP PowerShell transformation was executed with a separate delegated AllSites.Manage application and non-destructive defaults.
  • Documentation-agent findings were addressed before the PR was marked ready for review.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@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.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@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.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@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.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@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.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@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.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@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.

@TaoziZ03

Copy link
Copy Markdown
Contributor Author

@microsoft-github-policy-service agree company="Microsoft"

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 6a3b9ac4-0f42-433b-bc31-3e330dc995a4
@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.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 6a3b9ac4-0f42-433b-bc31-3e330dc995a4
@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.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@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.

@TaoziZ03 TaoziZ03 changed the title Add Microsoft 365 Assessment modernization guidance Add Classic Page Assessment and transformation guidance Jul 24, 2026
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@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

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@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

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@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

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@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

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

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

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: a7db0d98-be53-48c2-9488-9a226f457144
@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

@TaoziZ03
TaoziZ03 marked this pull request as ready for review July 27, 2026 07:23
@TaoziZ03 TaoziZ03 changed the title Add Classic Page Assessment and transformation guidance Add Classic Page Assessment and transformation handoff guidance Jul 27, 2026
@jansenbe
Bert Jansen (jansenbe) merged commit cca6b5b into SharePoint:main Jul 27, 2026
3 checks passed
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