Fix example intro sentences beta - #10016
Conversation
…eresourcerolescopes.md
…ibutedefinitions.md
There was a problem hiding this comment.
Pull request overview
This PR standardizes example-introduction wording across a large set of beta Microsoft Graph API reference topics by replacing informal phrases (for example, “Here’s an example…”) with more consistent, formal phrasing (for example, “The following example shows…”), without changing API semantics.
Changes:
- Standardize “Example” / “Request” / “Response” intro sentences across many beta API topics.
- Normalize some request/response lead-in text to consistently use “The following example shows…”.
- Minor formatting adjustments around example sections (for example, blank lines and note placement).
Reviewed changes
Copilot reviewed 155 out of 155 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| api-reference/beta/api/worksheetprotection-protect.md | Standardizes example intro wording. |
| api-reference/beta/api/worksheet-usedrange.md | Standardizes example intro wording. |
| api-reference/beta/api/worksheet-range.md | Standardizes example intro wording. |
| api-reference/beta/api/worksheet-delete.md | Standardizes example intro wording. |
| api-reference/beta/api/worksheet-cell.md | Standardizes example intro wording. |
| api-reference/beta/api/workforceintegration-update.md | Standardizes response example intro wording. |
| api-reference/beta/api/workbookrangeview-range.md | Standardizes example intro wording. |
| api-reference/beta/api/workbookrangeview-itemat.md | Standardizes example intro wording. |
| api-reference/beta/api/workbookrange-visibleview.md | Standardizes example intro wording. |
| api-reference/beta/api/workbookrange-rowsbelow.md | Standardizes example intro wording. |
| api-reference/beta/api/workbookrange-rowsabove.md | Standardizes example intro wording. |
| api-reference/beta/api/workbookrange-columnsbefore.md | Standardizes example intro wording. |
| api-reference/beta/api/workbookrange-columnsafter.md | Standardizes example intro wording. |
| api-reference/beta/api/workbookpivottable-refreshall.md | Standardizes example intro wording. |
| api-reference/beta/api/workbookpivottable-refresh.md | Standardizes example intro wording. |
| api-reference/beta/api/usersettings-update.md | Standardizes request example intro wording. |
| api-reference/beta/api/user-reminderview.md | Standardizes example intro wording. |
| api-reference/beta/api/user-post-notifications.md | Standardizes response example intro wording. |
| api-reference/beta/api/user-findmeetingtimes.md | Standardizes response example intro wording. |
| api-reference/beta/api/user-delta.md | Standardizes multiple response example intro sentences. |
| api-reference/beta/api/unifiedstoragequota-list-services.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/tiindicators-list.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/team-post.md | Standardizes example intro wording for a specific example section. |
| api-reference/beta/api/team-completemigration.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/tablesort-reapply.md | Standardizes example intro wording. |
| api-reference/beta/api/tablesort-clear.md | Standardizes example intro wording. |
| api-reference/beta/api/tablesort-apply.md | Standardizes example intro wording. |
| api-reference/beta/api/tablerowcollection-itemat.md | Standardizes example intro wording. |
| api-reference/beta/api/tablerow-range.md | Standardizes example intro wording. |
| api-reference/beta/api/tablerow-delete.md | Standardizes example intro wording. |
| api-reference/beta/api/tablecolumncollection-itemat.md | Standardizes example intro wording. |
| api-reference/beta/api/tablecolumncollection-add.md | Standardizes example intro wording. |
| api-reference/beta/api/tablecolumn-totalrowrange.md | Standardizes example intro wording. |
| api-reference/beta/api/tablecolumn-range.md | Standardizes example intro wording. |
| api-reference/beta/api/tablecolumn-headerrowrange.md | Standardizes example intro wording. |
| api-reference/beta/api/tablecolumn-delete.md | Standardizes example intro wording. |
| api-reference/beta/api/tablecolumn-databodyrange.md | Standardizes example intro wording. |
| api-reference/beta/api/tablecollection-add.md | Standardizes example intro wording. |
| api-reference/beta/api/table-totalrowrange.md | Standardizes example intro wording. |
| api-reference/beta/api/table-reapplyfilters.md | Standardizes example intro wording. |
| api-reference/beta/api/table-post-rows.md | Standardizes example intro wording for async request example. |
| api-reference/beta/api/table-headerrowrange.md | Standardizes example intro wording. |
| api-reference/beta/api/table-delete.md | Standardizes example intro wording. |
| api-reference/beta/api/table-databodyrange.md | Standardizes example intro wording. |
| api-reference/beta/api/table-converttorange.md | Standardizes example intro wording. |
| api-reference/beta/api/table-clearfilters.md | Standardizes example intro wording. |
| api-reference/beta/api/synchronization-synchronizationjob-pause.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/synchronization-synchronization-list-templates.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/servicestoragequotabreakdown-get.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/serviceprincipal-delete-delegatedpermissionclassifications.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/security-emailthreatsubmissionpolicy-get.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/security-emailthreatsubmission-get.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/section-copytosectiongroup.md | Standardizes example intro wording. |
| api-reference/beta/api/section-copytonotebook.md | Standardizes example intro wording. |
| api-reference/beta/api/schemaextension-get.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/schedule-share.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/reportroot-getteamsuseractivitytotaldistributioncounts.md | Standardizes request/response example intro wording across multiple examples. |
| api-reference/beta/api/reportroot-getsharepointsiteusagedetail.md | Standardizes request/response example intro wording across multiple examples. |
| api-reference/beta/api/reportroot-getoffice365servicesusercounts.md | Standardizes request/response example intro wording across multiple examples. |
| api-reference/beta/api/reportroot-getoffice365groupsactivitydetail.md | Standardizes request/response example intro wording across multiple examples. |
| api-reference/beta/api/reportroot-getformsuseractivityuserdetail.md | Standardizes request/response example intro wording across multiple examples. |
| api-reference/beta/api/reportroot-getbrowserusercounts.md | Standardizes request/response example intro wording across multiple examples. |
| api-reference/beta/api/reportroot-getbrowserdistributionusercounts.md | Standardizes request/response example intro wording across multiple examples. |
| api-reference/beta/api/reportroot-getazureadapplicationsigninsummary.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/rangesort-apply.md | Standardizes example intro wording. |
| api-reference/beta/api/rangeformat-autofitrows.md | Standardizes example intro wording. |
| api-reference/beta/api/rangeformat-autofitcolumns.md | Standardizes example intro wording. |
| api-reference/beta/api/rangefill-clear.md | Standardizes example intro wording. |
| api-reference/beta/api/rangebordercollection-itemat.md | Standardizes example intro wording. |
| api-reference/beta/api/range-usedrange.md | Standardizes example intro wording. |
| api-reference/beta/api/range-row.md | Standardizes example intro wording. |
| api-reference/beta/api/range-offsetrange.md | Standardizes example intro wording. |
| api-reference/beta/api/range-merge.md | Standardizes example intro wording. |
| api-reference/beta/api/range-lastrow.md | Standardizes example intro wording. |
| api-reference/beta/api/range-lastcolumn.md | Standardizes example intro wording. |
| api-reference/beta/api/range-lastcell.md | Standardizes example intro wording. |
| api-reference/beta/api/range-intersection.md | Standardizes example intro wording. |
| api-reference/beta/api/range-insert.md | Standardizes example intro wording. |
| api-reference/beta/api/range-entirerow.md | Standardizes example intro wording. |
| api-reference/beta/api/range-entirecolumn.md | Standardizes example intro wording. |
| api-reference/beta/api/range-delete.md | Standardizes example intro wording (including request-description sentence). |
| api-reference/beta/api/range-column.md | Standardizes example intro wording. |
| api-reference/beta/api/range-clear.md | Standardizes example intro wording. |
| api-reference/beta/api/range-cell.md | Standardizes example intro wording. |
| api-reference/beta/api/range-boundingrect.md | Standardizes example intro wording. |
| api-reference/beta/api/publishedresource-update.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/projectrome-get-recent-activities.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/profile-list-websites.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/profile-list-webaccounts.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/profile-list-skills.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/profile-list-projects.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/profile-list-positions.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/profile-list-names.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/profile-list-languages.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/profile-list-interests.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/profile-list-educationalactivities.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/profile-list-accounts.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/printershare-get.md | Standardizes response example intro wording for a $select variant. |
| api-reference/beta/api/post-reply.md | Standardizes example intro wording. |
| api-reference/beta/api/post-forward.md | Standardizes example intro wording. |
| api-reference/beta/api/personname-update.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/outlookuser-supportedlanguages.md | Standardizes example intro wording. |
| api-reference/beta/api/outlooktask-post-attachments.md | Standardizes request example intro wording. |
| api-reference/beta/api/orgcontact-delta.md | Standardizes multiple response example intro sentences. |
| api-reference/beta/api/notifications-post.md | Standardizes response example intro wording. |
| api-reference/beta/api/notebook-copynotebook.md | Standardizes example intro wording. |
| api-reference/beta/api/networkaccess-conditionalaccesssettings-get.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/nameditem-range.md | Standardizes example intro wording. |
| api-reference/beta/api/nameditem-addformulalocal.md | Standardizes example intro wording. |
| api-reference/beta/api/nameditem-add.md | Standardizes example intro wording. |
| api-reference/beta/api/message-unsubscribe.md | Standardizes example intro wording. |
| api-reference/beta/api/message-send.md | Standardizes example intro wording in a multi-example topic. |
| api-reference/beta/api/message-post-attachments.md | Standardizes response example intro wording. |
| api-reference/beta/api/message-move.md | Standardizes example intro wording. |
| api-reference/beta/api/message-copy.md | Standardizes example intro wording. |
| api-reference/beta/api/mailfolder-move.md | Standardizes example intro wording. |
| api-reference/beta/api/mailfolder-copy.md | Standardizes example intro wording. |
| api-reference/beta/api/listitem-update.md | Standardizes example intro wording for request scenario description. |
| api-reference/beta/api/listitem-create.md | Standardizes example intro wording. |
| api-reference/beta/api/identityuserflow-get.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/identitycontainer-post-b2cuserflows.md | Standardizes request/response example intro wording across multiple examples. |
| api-reference/beta/api/group-get.md | Standardizes request/response example intro wording across multiple examples. |
| api-reference/beta/api/group-delta.md | Standardizes multiple response example intro sentences. |
| api-reference/beta/api/event-tentativelyaccept.md | Standardizes example intro wording. |
| api-reference/beta/api/event-snoozereminder.md | Standardizes example intro wording. |
| api-reference/beta/api/event-post-attachments.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/event-forward.md | Standardizes example intro wording. |
| api-reference/beta/api/event-dismissreminder.md | Standardizes example intro wording. |
| api-reference/beta/api/event-decline.md | Standardizes example intro wording. |
| api-reference/beta/api/event-cancel.md | Standardizes example intro wording. |
| api-reference/beta/api/event-accept.md | Standardizes example intro wording. |
| api-reference/beta/api/driveitem-list-versions.md | Fixes and standardizes example intro wording for versions listing. |
| api-reference/beta/api/driveitem-delta.md | Standardizes example intro wording across initial request section. |
| api-reference/beta/api/directoryobject-delta.md | Standardizes multiple response example intro sentences. |
| api-reference/beta/api/directory-post-customsecurityattributedefinitions.md | Standardizes example intro wording for an advanced example section. |
| api-reference/beta/api/conversationthread-reply.md | Standardizes example intro wording. |
| api-reference/beta/api/connectorgroup-list.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/connector-list-memberof.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/checklistitem-update.md | Standardizes example intro wording across multiple requests. |
| api-reference/beta/api/checklistitem-get.md | Standardizes example intro wording across multiple requests. |
| api-reference/beta/api/chartseriescollection-itemat.md | Standardizes example intro wording. |
| api-reference/beta/api/chartpointscollection-itemat.md | Standardizes example intro wording. |
| api-reference/beta/api/chartlineformat-clear.md | Standardizes example intro wording. |
| api-reference/beta/api/chartfill-setsolidcolor.md | Standardizes example intro wording. |
| api-reference/beta/api/chartfill-clear.md | Standardizes example intro wording. |
| api-reference/beta/api/chartcollection-itemat.md | Standardizes example intro wording. |
| api-reference/beta/api/chartcollection-add.md | Standardizes example intro wording. |
| api-reference/beta/api/chart-setposition.md | Standardizes example intro wording. |
| api-reference/beta/api/chart-setdata.md | Standardizes example intro wording and normalizes response intro punctuation/spacing. |
| api-reference/beta/api/chart-image.md | Standardizes example intro wording. |
| api-reference/beta/api/chart-delete.md | Standardizes example intro wording and normalizes response intro punctuation/spacing. |
| api-reference/beta/api/certificatebasedauthconfiguration-delete.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/bookingbusiness-list-calendarview.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/authenticationcontextclassreference-update.md | Standardizes request/response example intro wording. |
| api-reference/beta/api/accesspackage-delete-accesspackageresourcerolescopes.md | Standardizes request/response example intro wording. |
|
|
||
| ### Response | ||
| Here's an example of the response. Note: The response object shown here might be shortened for readability. | ||
| The following example shows the response. |
|
|
||
| > [!NOTE] | ||
| > The response object shown here might be shortened for readability. | ||
| > >**Note:** The response object shown here might be shortened for readability. |
|
|
||
| ### Response | ||
| Here's an example of the response. Note: The response object shown here might be shortened for readability. | ||
| The following example shows the response. |
| ``` | ||
|
|
||
| Here's an example of the response, when using $select=id,displayName,capabilities | ||
| The following example shows the response, when using `$select=id,displayName,capabilities` |
|
Learn Build status updates of commit 290a3b1:
|
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
|
Learn Build status updates of commit 7248cb1:
|
|
Learn Build status updates of commit 4303d42:
|
This PR’s main objective is to standardize example-introduction wording across the beta API documentation by replacing variations like “Here’s an example” with “The following example,” so the docs read more consistently, use a more formal tone, and provide a uniform experience for readers without changing any API behavior or technical content.