Skip to content

SPE: document container type owner billing management - #11016

Open
Gregory Joseph (gnjoseph) wants to merge 3 commits into
SharePoint:mainfrom
gnjoseph:agents/featureauthzen-review-page-update
Open

SPE: document container type owner billing management#11016
Gregory Joseph (gnjoseph) wants to merge 3 commits into
SharePoint:mainfrom
gnjoseph:agents/featureauthzen-review-page-update

Conversation

@gnjoseph

@gnjoseph Gregory Joseph (gnjoseph) commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Category

  • Content fix
  • New article

Related issues

  • None

What's in this Pull Request?

This PR documents standard-billing self-service for SharePoint Embedded container type owners and aligns billing-role guidance across the SharePoint Embedded documentation.

  • Directs container type owners to the SharePoint Embedded Visual Studio Code extension or Model Context Protocol (MCP) server for standard-billing management.
  • Documents Attach billing in the Visual Studio Code extension and the MCP server's billing_setup and billing_check tools as the supported owner facilities.
  • Clarifies that non-administrator owners can manage standard billing only for container types they own.
  • Clarifies that SharePoint Embedded Administrators and Global Administrators can manage any standard-billed container type in the developer tenant.
  • Documents Billing Administrator or Global Administrator for consuming-tenant pass-through billing setup in the Microsoft 365 admin center.
  • Clarifies that the SharePoint Embedded Administrator role alone doesn't grant access to that Microsoft 365 billing procedure.
  • Preserves User org and user organization billing as names for the pass-through model.
  • Links the Azure Owner and Contributor role definitions where those roles are required.
  • Aligns developer, ISV, customer-setup, troubleshooting, and admin guidance across 12 existing articles.

The change intentionally doesn't add a dated What's new entry. Release timing remains separate from the documentation draft.

Validation

  • SPE style, technical-accuracy, and implementation reviewers reviewed the original 12-article correction and the focused five-article review-feedback update.
  • The SPE fix-suggester refined the billing-role draft. Focused implementation review and final style and accuracy repasses for the abstraction update returned no findings.
  • A full DocFX build completed successfully with zero warnings or errors for the target articles. Existing unrelated repository warnings remain.
  • git diff --check passes.
  • Existing ms.date and other selected metadata values are unchanged from main.
  • Relative Markdown links, heading anchors, VS Code and MCP workflow links, and Azure Owner and Contributor links were validated.
  • The public content contains no raw billing resource payload, internal permission names, app IDs, rollout controls, internal links, or test-tenant details.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit ed7166e:

✅ Validation status: passed

File Status Preview URL Details
docs/embedded/admin/setup-billing-microsoft-365-admin-center.md ✅Succeeded View
docs/embedded/build/create-container-type.md ✅Succeeded View
docs/embedded/plan/choose-billing-model.md ✅Succeeded View
docs/embedded/publish/choose-app-billing-model.md ✅Succeeded View

For more details, please refer to the build report.

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

Greg Joseph and others added 2 commits August 31, 2026 13:29
Add the Azure Resource Manager flow for owner-scoped standard billing and clarify the separate administrator and pass-through billing boundaries.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Restore Billing Administrator support for consuming-tenant pass-through billing and clarify the separate container type owner, SharePoint Embedded Administrator, and Global Administrator scopes. Add Azure RBAC role links and keep product terminology consistent.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@gnjoseph
Gregory Joseph (gnjoseph) force-pushed the agents/featureauthzen-review-page-update branch from ed7166e to 8499680 Compare August 31, 2026 20:31
@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.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documents self-service standard billing and aligns billing-role guidance across SharePoint Embedded documentation.

Changes:

  • Adds an Azure CLI workflow for container type owners.
  • Clarifies standard and pass-through billing permissions.
  • Aligns customer setup, administration, and troubleshooting guidance.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated no comments.

Show a summary per file
File Description
docs/embedded/reference/troubleshooting.md Updates pass-through billing roles.
docs/embedded/publish/validate-customer-installation.md Separates setup and billing responsibilities.
docs/embedded/publish/customer-tenant-setup-guide.md Clarifies customer roles and prerequisites.
docs/embedded/publish/choose-app-billing-model.md Documents billing ownership and permissions.
docs/embedded/plan/container-types-containers.md Updates pass-through billing roles.
docs/embedded/plan/choose-billing-model.md Adds owner self-service billing instructions.
docs/embedded/build/create-container-type.md Aligns container type billing guidance.
docs/embedded/admin/setup-billing-microsoft-365-admin-center.md Clarifies consuming-tenant billing setup.
docs/embedded/admin/install-sharepoint-embedded-app.md Updates installation billing roles.
docs/embedded/admin/create-apps-sharepoint-admin-center.md Clarifies owner billing permissions.
docs/embedded/admin/consuming-tenant-admin.md Updates pass-through billing requirements.
docs/embedded/admin/admin-overview.md Adds Billing Administrator responsibilities.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/embedded/admin/create-apps-sharepoint-admin-center.md Outdated
Comment thread docs/embedded/build/create-container-type.md Outdated
Comment thread docs/embedded/build/create-container-type.md Outdated
Comment thread docs/embedded/build/create-container-type.md Outdated
Comment thread docs/embedded/plan/choose-billing-model.md Outdated
Comment thread docs/embedded/publish/choose-app-billing-model.md Outdated
Replace raw Azure Resource Manager and Azure CLI guidance with the SharePoint Embedded Visual Studio Code extension and MCP server workflows requested in review. Preserve owner-scoped and administrator billing boundaries.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@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.

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.

3 participants