Skip to content

Fixed Note blockquote formatting in response examples in beta topics#9908

Merged
Danipocket merged 4 commits into
microsoftgraph:mainfrom
JarbasHorst:fix-note-blockquote-beta
May 19, 2026
Merged

Fixed Note blockquote formatting in response examples in beta topics#9908
Danipocket merged 4 commits into
microsoftgraph:mainfrom
JarbasHorst:fix-note-blockquote-beta

Conversation

@JarbasHorst
Copy link
Copy Markdown
Contributor

Summary

Fixed incorrect formatting of the "Note" disclaimer in response examples across beta API topics.

The "Note" sentence was inlined with the introductory sentence instead of being rendered as a proper Markdown blockquote, reducing its visibility and breaking documentation formatting conventions.

Changes

  • Separated the "Note" sentence from the introductory sentence
  • Formatted it as a proper Markdown blockquote using > **Note:**

Related

  • No issue linked — formatting-only fix, no content changes

Copilot AI review requested due to automatic review settings May 18, 2026 09:49
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 normalizes the "Note: The response object shown here might be shortened for readability." disclaimer across ~150 beta API reference topics. The previous markdown inlined the disclaimer on the same line as the ### Response heading, which prevented it from rendering correctly. The fix puts the introductory sentence on its own line and renders the note as a proper Markdown blockquote (> **Note:** ...), matching the existing convention used widely throughout the beta and v1.0 API docs.

Changes:

  • Split the inline "Note" sentence from the introductory sentence under ### Response (and a few #### Response / ##### Response) sections.
  • Reformat the note using a > **Note:** ... blockquote so it renders as a callout.
  • Apply the same fix consistently across the affected beta API topics (workbook/range/table/chart/planner/outlook/user/calendar/etc.).

Reviewed changes

Copilot reviewed 231 out of 231 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
api-reference/beta/api/contenttype-update.md Adds "The following example is a request." under ### Request; unrelated to the PR's note-formatting scope.
api-reference/beta/api/application-delta.md Splits inline note and adds intro sentence (note had no preceding sentence before).
api-reference/beta/api/rangeformat-update.md Applies the same note-blockquote reformat in 9 example sections.
api-reference/beta/api/attachment-get.md Applies the same note-blockquote reformat in 4 example sections.
api-reference/beta/api/calendar-list-events.md Applies the same note-blockquote reformat in 3 example sections.
api-reference/beta/api/eventmessage-post-attachments.md, event-post-attachments.md, outlooktask-post-attachments.md, message-post-attachments.md, eventmessage-list-attachments.md, message-list-attachments.md, message-createreply.md, message-createreplyall.md, event-list-attachments.md, post-list-attachments.md Same note-blockquote reformat for attachment/message/event topics.
api-reference/beta/api/{worksheet*,workbook*,range*,table*,chart*,nameditem*,tablecolumn*,tablerow*,tablesort*,charttitle*,chartseries*,chartpoint*,chartlegend*,chartgridlines*,chartfont*,chartdatalabels*,chartcollection*,chartaxis*,chartaxistitle*,chartlineformat*,chart-,rangeborder,rangebordercollection*,rangefont*,rangefill*,rangeformat*}.md (Excel/workbook topics) Same note-blockquote reformat applied uniformly.
api-reference/beta/api/{planner*,outlook*,user-,usersettings-,calendar*,calendargroup*,contact*,contactfolder*,mailfolder-,messagerule-,message-,conversationthread-,post-,inferenceclassification-,insights-,onenoteoperation-,subscribedsku-,serviceprincipal-,connector*,connectorgroup-,directoryrole,directoryroletemplate-,directorysettingtemplate-,device-,bookingcustomer-,bookingcurrency-,bookingbusiness-,team-clone,educationuser-update,administrativeunit-,orgcontact-}.md Same note-blockquote reformat applied uniformly across remaining topics.

Comment thread api-reference/beta/api/contenttype-update.md Outdated
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit d97d0c6:

⚠️ Validation status: warnings

File Status Preview URL Details
api-reference/beta/api/connector-post-memberof.md ⚠️Warning Details
api-reference/beta/api/outlooktask-list-attachments.md ⚠️Warning Details
api-reference/beta/api/outlooktask-post-attachments.md ⚠️Warning Details
api-reference/beta/api/outlooktaskfolder-list-tasks.md ⚠️Warning Details
api-reference/beta/api/outlooktaskgroup-list-taskfolders.md ⚠️Warning Details
api-reference/beta/api/outlooktaskgroup-post-taskfolders.md ⚠️Warning Details
api-reference/beta/api/outlookuser-list-taskfolders.md ⚠️Warning Details
api-reference/beta/api/outlookuser-post-taskfolders.md ⚠️Warning Details
api-reference/beta/api/calendar-list-events.md 💡Suggestion Details
api-reference/beta/api/administrativeunit-delete-scopedrolemembers.md ✅Succeeded
api-reference/beta/api/administrativeunit-get-scopedrolemembers.md ✅Succeeded
api-reference/beta/api/administrativeunit-list-scopedrolemembers.md ✅Succeeded
api-reference/beta/api/administrativeunit-post-scopedrolemembers.md ✅Succeeded
api-reference/beta/api/application-delta.md ✅Succeeded
api-reference/beta/api/attachment-get.md ✅Succeeded
api-reference/beta/api/bookingbusiness-post-bookingbusinesses.md ✅Succeeded
api-reference/beta/api/bookingbusiness-update.md ✅Succeeded
api-reference/beta/api/bookingcurrency-get.md ✅Succeeded
api-reference/beta/api/bookingcustomer-update.md ✅Succeeded
api-reference/beta/api/calendar-get.md ✅Succeeded
api-reference/beta/api/calendar-getschedule.md ✅Succeeded
api-reference/beta/api/calendar-update.md ✅Succeeded
api-reference/beta/api/calendargroup-delete.md ✅Succeeded
api-reference/beta/api/calendargroup-list-calendars.md ✅Succeeded
api-reference/beta/api/calendargroup-post-calendars.md ✅Succeeded

This comment lists only the first 25 files in the pull request.

api-reference/beta/api/connector-post-memberof.md

  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Add connector to connectorGroup' is duplicated with other articles: 'beta/api/connector-post-memberof.md(11,1), beta/api/connectorgroup-post-members.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/outlooktask-list-attachments.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List attachments - Microsoft Graph beta' is duplicated in: 'beta/api/note-list-attachments.md(2,8), beta/api/outlooktask-list-attachments.md(2,8)'. Titles must be unique within a docset.

api-reference/beta/api/outlooktask-post-attachments.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Create attachment - Microsoft Graph beta' is duplicated in: 'beta/api/note-post-attachments.md(2,8), beta/api/outlooktask-post-attachments.md(2,8)'. Titles must be unique within a docset.

api-reference/beta/api/outlooktaskfolder-list-tasks.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List tasks - Microsoft Graph beta' is duplicated in: 'beta/api/outlooktaskfolder-list-tasks.md(2,8), beta/api/outlookuser-list-tasks.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'List tasks (deprecated)' is duplicated with other articles: 'beta/api/outlooktaskfolder-list-tasks.md(11,1), beta/api/outlookuser-list-tasks.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/outlooktaskgroup-list-taskfolders.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List taskFolders - Microsoft Graph beta' is duplicated in: 'beta/api/outlooktaskgroup-list-taskfolders.md(2,8), beta/api/outlookuser-list-taskfolders.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'List taskFolders (deprecated)' is duplicated with other articles: 'beta/api/outlooktaskgroup-list-taskfolders.md(11,1), beta/api/outlookuser-list-taskfolders.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/outlooktaskgroup-post-taskfolders.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Create outlookTaskFolder - Microsoft Graph beta' is duplicated in: 'beta/api/outlooktaskgroup-post-taskfolders.md(2,8), beta/api/outlookuser-post-taskfolders.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Create outlookTaskFolder (deprecated)' is duplicated with other articles: 'beta/api/outlooktaskgroup-post-taskfolders.md(11,1), beta/api/outlookuser-post-taskfolders.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/outlookuser-list-taskfolders.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List taskFolders - Microsoft Graph beta' is duplicated in: 'beta/api/outlooktaskgroup-list-taskfolders.md(2,8), beta/api/outlookuser-list-taskfolders.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'List taskFolders (deprecated)' is duplicated with other articles: 'beta/api/outlooktaskgroup-list-taskfolders.md(11,1), beta/api/outlookuser-list-taskfolders.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/outlookuser-post-taskfolders.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Create outlookTaskFolder - Microsoft Graph beta' is duplicated in: 'beta/api/outlooktaskgroup-post-taskfolders.md(2,8), beta/api/outlookuser-post-taskfolders.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Create outlookTaskFolder (deprecated)' is duplicated with other articles: 'beta/api/outlooktaskgroup-post-taskfolders.md(11,1), beta/api/outlookuser-post-taskfolders.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/calendar-list-events.md

  • Line 25, Column 294: [Suggestion: preserve-view-not-set - See documentation] You've pinned this link to a specific version of content with the view parameter. It's recommended not to pin a version unless that version is A) not the default view and B) the context is about that version specifically. To proceed with pinning a version add the &preserve-view=true to the URL. Otherwise, remove the view parameter. URL: /powershell/module/exchange/add-mailboxfolderpermission?view=exchange-ps#-sharingpermissionflags

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.

@JarbasHorst
Copy link
Copy Markdown
Contributor Author

Hi @Danipocket, here's another one ready and reviewed ;) Thanks!

@JarbasHorst JarbasHorst changed the title Fix note blockquote beta Fixed Note blockquote formatting in response examples in beta topics May 18, 2026
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 6c683e4:

⚠️ Validation status: warnings

File Status Preview URL Details
api-reference/beta/api/connector-post-memberof.md ⚠️Warning Details
api-reference/beta/api/outlooktask-list-attachments.md ⚠️Warning Details
api-reference/beta/api/outlooktask-post-attachments.md ⚠️Warning Details
api-reference/beta/api/outlooktaskfolder-list-tasks.md ⚠️Warning Details
api-reference/beta/api/outlooktaskgroup-list-taskfolders.md ⚠️Warning Details
api-reference/beta/api/outlooktaskgroup-post-taskfolders.md ⚠️Warning Details
api-reference/beta/api/outlookuser-list-taskfolders.md ⚠️Warning Details
api-reference/beta/api/outlookuser-post-taskfolders.md ⚠️Warning Details
api-reference/beta/api/calendar-list-events.md 💡Suggestion Details
api-reference/beta/api/administrativeunit-delete-scopedrolemembers.md ✅Succeeded
api-reference/beta/api/administrativeunit-get-scopedrolemembers.md ✅Succeeded
api-reference/beta/api/administrativeunit-list-scopedrolemembers.md ✅Succeeded
api-reference/beta/api/administrativeunit-post-scopedrolemembers.md ✅Succeeded
api-reference/beta/api/application-delta.md ✅Succeeded
api-reference/beta/api/attachment-get.md ✅Succeeded
api-reference/beta/api/bookingbusiness-post-bookingbusinesses.md ✅Succeeded
api-reference/beta/api/bookingbusiness-update.md ✅Succeeded
api-reference/beta/api/bookingcurrency-get.md ✅Succeeded
api-reference/beta/api/bookingcustomer-update.md ✅Succeeded
api-reference/beta/api/calendar-get.md ✅Succeeded
api-reference/beta/api/calendar-getschedule.md ✅Succeeded
api-reference/beta/api/calendar-update.md ✅Succeeded
api-reference/beta/api/calendargroup-delete.md ✅Succeeded
api-reference/beta/api/calendargroup-list-calendars.md ✅Succeeded
api-reference/beta/api/calendargroup-post-calendars.md ✅Succeeded

This comment lists only the first 25 files in the pull request.

api-reference/beta/api/connector-post-memberof.md

  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Add connector to connectorGroup' is duplicated with other articles: 'beta/api/connector-post-memberof.md(11,1), beta/api/connectorgroup-post-members.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/outlooktask-list-attachments.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List attachments - Microsoft Graph beta' is duplicated in: 'beta/api/note-list-attachments.md(2,8), beta/api/outlooktask-list-attachments.md(2,8)'. Titles must be unique within a docset.

api-reference/beta/api/outlooktask-post-attachments.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Create attachment - Microsoft Graph beta' is duplicated in: 'beta/api/note-post-attachments.md(2,8), beta/api/outlooktask-post-attachments.md(2,8)'. Titles must be unique within a docset.

api-reference/beta/api/outlooktaskfolder-list-tasks.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List tasks - Microsoft Graph beta' is duplicated in: 'beta/api/outlooktaskfolder-list-tasks.md(2,8), beta/api/outlookuser-list-tasks.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'List tasks (deprecated)' is duplicated with other articles: 'beta/api/outlooktaskfolder-list-tasks.md(11,1), beta/api/outlookuser-list-tasks.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/outlooktaskgroup-list-taskfolders.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List taskFolders - Microsoft Graph beta' is duplicated in: 'beta/api/outlooktaskgroup-list-taskfolders.md(2,8), beta/api/outlookuser-list-taskfolders.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'List taskFolders (deprecated)' is duplicated with other articles: 'beta/api/outlooktaskgroup-list-taskfolders.md(11,1), beta/api/outlookuser-list-taskfolders.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/outlooktaskgroup-post-taskfolders.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Create outlookTaskFolder - Microsoft Graph beta' is duplicated in: 'beta/api/outlooktaskgroup-post-taskfolders.md(2,8), beta/api/outlookuser-post-taskfolders.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Create outlookTaskFolder (deprecated)' is duplicated with other articles: 'beta/api/outlooktaskgroup-post-taskfolders.md(11,1), beta/api/outlookuser-post-taskfolders.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/outlookuser-list-taskfolders.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List taskFolders - Microsoft Graph beta' is duplicated in: 'beta/api/outlooktaskgroup-list-taskfolders.md(2,8), beta/api/outlookuser-list-taskfolders.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'List taskFolders (deprecated)' is duplicated with other articles: 'beta/api/outlooktaskgroup-list-taskfolders.md(11,1), beta/api/outlookuser-list-taskfolders.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/outlookuser-post-taskfolders.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Create outlookTaskFolder - Microsoft Graph beta' is duplicated in: 'beta/api/outlooktaskgroup-post-taskfolders.md(2,8), beta/api/outlookuser-post-taskfolders.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Create outlookTaskFolder (deprecated)' is duplicated with other articles: 'beta/api/outlooktaskgroup-post-taskfolders.md(11,1), beta/api/outlookuser-post-taskfolders.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/calendar-list-events.md

  • Line 25, Column 294: [Suggestion: preserve-view-not-set - See documentation] You've pinned this link to a specific version of content with the view parameter. It's recommended not to pin a version unless that version is A) not the default view and B) the context is about that version specifically. To proceed with pinning a version add the &preserve-view=true to the URL. Otherwise, remove the view parameter. URL: /powershell/module/exchange/add-mailboxfolderpermission?view=exchange-ps#-sharingpermissionflags

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.

@Danipocket Danipocket merged commit 87bf943 into microsoftgraph:main May 19, 2026
7 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.

3 participants