Update graph and guidance docs to heft

[Ashlesha-MSFT]

Category

• Content fix

Related issues

• fixes SPFx Docs Update for Heft toolchain: using-microsoft-graph-apis.md #10553
• fixes SPFx Docs Update for Heft toolchain: add-jqueryui-accordion-to-web-part.md #10552
• fixes SPFx Docs Update for Heft toolchain: using-web-part-as-ms-teams-tab.md #10556
• fixes SPFx Docs Update for Heft toolchain: provision-sp-assets-from-package.md #10555
• fixes SPFx Docs Update for Heft toolchain: build-web-part-microsoft-graph-toolkit.md #10554

What's in this Pull Request?

• Update using-microsoft-graph-apis.md:

  • Remove migration WIP banner
  • Modernize Graph API calls from callback to Promise-based pattern
  • Add proper error handling with .catch()
  • Improve TypeScript typing and null safety
  • Update commands: gulp to heft (build/package-solution)
  • Add null coalescing operator and null checks
  • Fix code formatting with consistent indentation

• Update simplify-adding-web-parts-with-preconfigured-entries.md:

  • Update ms.date to 01/01/2026
  • Migrate commands from gulp to heft
  • Update heft start command in all examples

• Update graph-helloworld-webpart-on-page.png"

[learn-build-service-prod]

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]

Learn Build status updates of commit dfb2529:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/images/graph-helloworld-webpart-on-page.png	✅Succeeded	View
docs/spfx/web-parts/get-started/add-jqueryui-accordion-to-web-part.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-microsoft-graph-apis.md	✅Succeeded	View
docs/spfx/web-parts/guidance/simplify-adding-web-parts-with-preconfigured-entries.md	✅Succeeded	View

For more details, please refer to the build report.

[Ashlesha-MSFT]

@andrewconnell ,
I noticed that some changes for this documentation weren't synced with docs/spfx/web-parts/guidance/simplify-adding-web-parts-with-preconfigured-entries.md from my local branch, so I've included those updates in this PR as well to ensure consistency across the documentation.

Going forward, I'll double-check PRs after creation to ensure all related changes are properly included before submission.

[learn-build-service-prod]

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]

Learn Build status updates of commit 330ba9c:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/images/graph-helloworld-webpart-on-page.png	✅Succeeded	View
docs/spfx/web-parts/get-started/add-jqueryui-accordion-to-web-part.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-microsoft-graph-apis.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-web-part-as-ms-teams-tab.md	✅Succeeded	View
docs/spfx/web-parts/guidance/simplify-adding-web-parts-with-preconfigured-entries.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

Learn Build status updates of commit 2885303:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/images/graph-helloworld-webpart-on-page.png	✅Succeeded	View
docs/spfx/web-parts/get-started/add-jqueryui-accordion-to-web-part.md	✅Succeeded	View
docs/spfx/web-parts/get-started/provision-sp-assets-from-package.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-microsoft-graph-apis.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-web-part-as-ms-teams-tab.md	✅Succeeded	View
docs/spfx/web-parts/guidance/simplify-adding-web-parts-with-preconfigured-entries.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

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]

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]

Learn Build status updates of commit 6589533:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/images/graph-helloworld-webpart-on-page.png	✅Succeeded	View
docs/spfx/web-parts/get-started/add-jqueryui-accordion-to-web-part.md	✅Succeeded	View
docs/spfx/web-parts/get-started/build-web-part-microsoft-graph-toolkit.md	✅Succeeded	View
docs/spfx/web-parts/get-started/provision-sp-assets-from-package.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-microsoft-graph-apis.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-web-part-as-ms-teams-tab.md	✅Succeeded	View
docs/spfx/web-parts/guidance/simplify-adding-web-parts-with-preconfigured-entries.md	✅Succeeded	View

For more details, please refer to the build report.

[andrewconnell]

Thanks for the submission @Ashlesha-MSFT ... few changes requested before we can merge this.

[learn-build-service-prod]

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]

Learn Build status updates of commit 411845f:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
docs/spfx/web-parts/get-started/using-microsoft-graph-apis.md	⚠️Warning	View	Details
docs/images/graph-helloworld-webpart-on-page.png	✅Succeeded	n/a (file deleted or renamed)
docs/spfx/web-parts/get-started/add-jqueryui-accordion-to-web-part.md	✅Succeeded	View
docs/spfx/web-parts/get-started/build-web-part-microsoft-graph-toolkit.md	✅Succeeded	View
docs/spfx/web-parts/get-started/provision-sp-assets-from-package.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-web-part-as-ms-teams-tab.md	✅Succeeded	View
docs/spfx/web-parts/guidance/simplify-adding-web-parts-with-preconfigured-entries.md	✅Succeeded	View

docs/spfx/web-parts/get-started/using-microsoft-graph-apis.md

• Line 230, Column 5: [Warning: file-not-found - See documentation] Invalid file link: '../../../images/graph-helloworld-webpart-on-page.png'.

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]

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]

Learn Build status updates of commit f4bb421:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/images/graph-helloworld-webpart-on-page.png	✅Succeeded	View
docs/spfx/web-parts/get-started/add-jqueryui-accordion-to-web-part.md	✅Succeeded	View
docs/spfx/web-parts/get-started/build-web-part-microsoft-graph-toolkit.md	✅Succeeded	View
docs/spfx/web-parts/get-started/provision-sp-assets-from-package.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-microsoft-graph-apis.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-web-part-as-ms-teams-tab.md	✅Succeeded	View
docs/spfx/web-parts/guidance/simplify-adding-web-parts-with-preconfigured-entries.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

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]

Learn Build status updates of commit cffef7b:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/images/graph-helloworld-webpart-on-page.png	✅Succeeded	View
docs/spfx/web-parts/get-started/add-jqueryui-accordion-to-web-part.md	✅Succeeded	View
docs/spfx/web-parts/get-started/build-web-part-microsoft-graph-toolkit.md	✅Succeeded	View
docs/spfx/web-parts/get-started/provision-sp-assets-from-package.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-microsoft-graph-apis.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-web-part-as-ms-teams-tab.md	✅Succeeded	View
docs/spfx/web-parts/guidance/simplify-adding-web-parts-with-preconfigured-entries.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

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]

Learn Build status updates of commit c833258:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/images/graph-helloworld-webpart-on-page.png	✅Succeeded	View
docs/spfx/web-parts/get-started/add-jqueryui-accordion-to-web-part.md	✅Succeeded	View
docs/spfx/web-parts/get-started/build-web-part-microsoft-graph-toolkit.md	✅Succeeded	View
docs/spfx/web-parts/get-started/provision-sp-assets-from-package.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-microsoft-graph-apis.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-web-part-as-ms-teams-tab.md	✅Succeeded	View
docs/spfx/web-parts/guidance/simplify-adding-web-parts-with-preconfigured-entries.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

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]

Learn Build status updates of commit fe5d4bc:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/images/graph-helloworld-webpart-on-page.png	✅Succeeded	View
docs/spfx/web-parts/get-started/add-jqueryui-accordion-to-web-part.md	✅Succeeded	View
docs/spfx/web-parts/get-started/build-web-part-microsoft-graph-toolkit.md	✅Succeeded	View
docs/spfx/web-parts/get-started/provision-sp-assets-from-package.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-microsoft-graph-apis.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-web-part-as-ms-teams-tab.md	✅Succeeded	View
docs/spfx/web-parts/guidance/simplify-adding-web-parts-with-preconfigured-entries.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

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]

Learn Build status updates of commit e988b3e:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/images/graph-helloworld-webpart-on-page.png	✅Succeeded	View
docs/spfx/web-parts/get-started/add-jqueryui-accordion-to-web-part.md	✅Succeeded	View
docs/spfx/web-parts/get-started/build-web-part-microsoft-graph-toolkit.md	✅Succeeded	View
docs/spfx/web-parts/get-started/provision-sp-assets-from-package.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-microsoft-graph-apis.md	✅Succeeded	View
docs/spfx/web-parts/get-started/using-web-part-as-ms-teams-tab.md	✅Succeeded	View
docs/spfx/web-parts/guidance/simplify-adding-web-parts-with-preconfigured-entries.md	✅Succeeded	View

For more details, please refer to the build report.