Merge pull request #2898 from juliemturner/version-4

Merging in PR#2887
pnp · Jan 12, 2024 · 9928c2f · 9928c2f
2 parents 07a7e39 + 69a5e71
commit 9928c2f
Show file tree

Hide file tree

Showing 21 changed files with 168 additions and 95 deletions.
diff --git a/docs/graph/analytics.md b/docs/graph/analytics.md
@@ -2,7 +2,11 @@
 
 The ability to get analytics for OneDrive and SharePoint drive items, SharePoint sites, and SharePoint list items.
 
-## IInvitations
+More information can be found in the official Graph documentation:
+
+- [Analytics Resource Type](https://docs.microsoft.com/en-us/graph/api/itemanalytics-get?view=graph-rest-1.0)
+
+## IAnalyticsOptions
 
 [![Invokable Banner](https://img.shields.io/badge/Invokable-informational.svg)](../concepts/invokable.md) [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  
 

diff --git a/docs/graph/appCatalog.md b/docs/graph/appCatalog.md
@@ -2,6 +2,10 @@
 
 The ability to use Teams App Catalog
 
+More information can be found in the official Graph documentation:
+
+- [App Catalogs Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/teamsapp?view=graph-rest-1.0)
+
 ## AppCatalog, IAppCatalog
 
 [![Invokable Banner](https://img.shields.io/badge/Invokable-informational.svg)](../concepts/invokable.md) [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  

diff --git a/docs/graph/bookings.md b/docs/graph/bookings.md
@@ -2,7 +2,7 @@
 
 Represents the Bookings services available to a user.
 
-You can learn more  by reading the [Official Microsoft Graph Documentation](https://docs.microsoft.com/en-us/graph/api/resources/booking-api-overview?view=graph-rest-1.0).
+You can learn more  by reading the [Bookings Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/booking-api-overview?view=graph-rest-1.0).
 
 ## IBookingCurrencies, IBookingCurrency, IBookingBusinesses, IBookingBusiness, IBookingAppointments, IBookingAppointment, IBookingCustomers, IBookingCustomer, IBookingServices, IBookingService, IBookingStaffMembers, IBookingStaffMember,  IBookingCustomQuestions, IBookingCustomQuestion
 

diff --git a/docs/graph/cloud-communications.md b/docs/graph/cloud-communications.md
@@ -4,7 +4,7 @@ The ability to retrieve information about a user's presence, including their ava
 
 More information can be found in the official Graph documentation:
 
-- [Presence Type](https://docs.microsoft.com/en-us/graph/api/resources/presence?view=graph-rest-1.0)
+- [Cloud Communications Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/presence?view=graph-rest-1.0)
 
 ## IPresence
 

diff --git a/docs/graph/files.md b/docs/graph/files.md
@@ -3,6 +3,10 @@
 The ability to manage drives and drive items in Onedrive is a capability introduced in version 1.2.4 of @pnp/graph. Through the methods described
 you can manage drives and drive items in Onedrive.
 
+More information can be found in the official Graph documentation:
+
+- [Drive/Files Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/onedrive?view=graph-rest-1.0)
+
 ## IInvitations
 
 [![Invokable Banner](https://img.shields.io/badge/Invokable-informational.svg)](../concepts/invokable.md) [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  

diff --git a/docs/graph/groups.md b/docs/graph/groups.md
@@ -4,7 +4,7 @@ Groups are collections of users and other principals who share access to resourc
 
 Note: Groups can only be created through work or school accounts. Personal Microsoft accounts don't support groups.
 
-You can learn more about Microsoft Graph Groups by reading the [Official Microsoft Graph Documentation](https://docs.microsoft.com/en-us/graph/api/resources/groups-overview).
+You can learn more about Microsoft Graph Groups by reading the [Groups Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/groups-overview).
 
 ## IGroup, IGroups
 

diff --git a/docs/graph/insights.md b/docs/graph/insights.md
@@ -2,6 +2,11 @@
 
 This module helps you get Insights in form of ***Trending***, ***Used*** and ***Shared***. The results are based on relationships calculated using advanced analytics and machine learning techniques.
 
+More information can be found in the official Graph documentation:
+
+- [Insights Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/officegraphinsights?view=graph-rest-1.0)
+
+
 ## IInsights
 
 [![Invokable Banner](https://img.shields.io/badge/Invokable-informational.svg)](../concepts/invokable.md) [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  

diff --git a/docs/graph/invitations.md b/docs/graph/invitations.md
@@ -2,6 +2,10 @@
 
 The ability invite an external user via the invitation manager
 
+More information can be found in the official Graph documentation:
+
+- [Invitations Resource Type](https://docs.microsoft.com/en-us/graph/api/invitation-post?view=graph-rest-1.0)
+
 ## IInvitations
 
 [![Invokable Banner](https://img.shields.io/badge/Invokable-informational.svg)](../concepts/invokable.md) [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  

diff --git a/docs/graph/items.md b/docs/graph/items.md
@@ -1,5 +1,10 @@
 # @pnp/graph/items
 
+More information can be found in the official Graph documentation:
+
+- [List Item Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/listitem?view=graph-rest-1.0)
+
+## IListItems, IListItem, IListItemAddResult, IDocumentSetVersion, IDocumentSetVersions IDocumentSetVersionAddResult,
 [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  
 
 ### Get list items

diff --git a/docs/graph/lists.md b/docs/graph/lists.md
@@ -4,6 +4,7 @@ More information can be found in the official Graph documentation:
 
 - [List Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/list?view=graph-rest-1.0)
 
+## IList, ILists, IListAddResult
 [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  
 
 ## Get Lists

diff --git a/docs/graph/mail-categories.md b/docs/graph/mail-categories.md
@@ -1,6 +1,8 @@
 # Graph Mail Categories
 
-You can learn more  by reading the [Official Microsoft Graph Documentation](https://docs.microsoft.com/en-us/graph/api/resources/outlookuser?view=graph-rest-1.0).
+More information can be found in the official Graph documentation:
+
+- [Outlook Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/outlookuser?view=graph-rest-1.0)
 
 ## IUsers, IUser, IPeople
 

diff --git a/docs/graph/operations.md b/docs/graph/operations.md
@@ -2,6 +2,11 @@
 
 Provides capabilities related to rich long-running operations.
 
+More information can be found in the official Graph documentation:
+
+- [Operations Resource Type](https://docs.microsoft.com/en-us/graph/api/site-list-operations?view=graph-rest-1.0)
+
+
 [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  
 
 ## list site operations

diff --git a/docs/graph/photos.md b/docs/graph/photos.md
@@ -2,8 +2,9 @@
 
 A profile photo of a user, group or an Outlook contact accessed from Exchange Online or Azure Active Directory (AAD). It's binary data not encoded in base-64.
 
-You can learn more about Microsoft Graph users by reading the [Official Microsoft Graph Documentation](https://docs.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0).
+More information can be found in the official Graph documentation:
 
+- [Photos Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/profilephoto?view=graph-rest-1.0)
 ## IPhoto
 
 [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  
@@ -60,12 +61,12 @@ await graph.me.photo.setContent(file);
 
 ```TypeScript
 import { graphfi } from "@pnp/graph";
-import "@pnp/graph/users";
+import "@pnp/graph/groups";
 import "@pnp/graph/photos";
 
 const graph = graphfi(...);
 
 const input = <HTMLInputElement>document.getElementById("thefileinput");
 const file = input.files[0];
-await graph.me.photo.setContent(file);
+await graph.groups.getById("7d2b9355-0891-47d3-84c8-bf2cd9c62177").photo.setContent(file);
 ```
diff --git a/docs/graph/planner.md b/docs/graph/planner.md
@@ -3,6 +3,10 @@
 The ability to manage plans and tasks in Planner is a capability introduced in version 1.2.4 of @pnp/graph. Through the methods described
 you can add, update and delete items in Planner.
 
+More information can be found in the official Graph documentation:
+
+- [Planner Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/plannertask?view=graph-rest-1.0)
+
 ## IInvitations
 
 [![Invokable Banner](https://img.shields.io/badge/Invokable-informational.svg)](../concepts/invokable.md) [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  

diff --git a/docs/graph/search.md b/docs/graph/search.md
@@ -2,6 +2,11 @@
 
 The search module allows you to access the Microsoft Graph Search API. You can read full details of using the API, for library examples please see below.
 
+More information can be found in the official Graph documentation:
+
+- [Search Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/search-api-overview?view=graph-rest-1.0)
+
+
 [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  
 
 ## Call graph.query

diff --git a/docs/graph/shares.md b/docs/graph/shares.md
@@ -2,6 +2,10 @@
 
 The shares module allows you to access shared files, or any file in the tenant using encoded file urls.
 
+More information can be found in the official Graph documentation:
+
+- [Shares Resource Type](https://docs.microsoft.com/en-us/graph/api/shares-get?view=graph-rest-1.0)
+
 [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)
 
 ## Access a Share by Id

diff --git a/docs/graph/sites.md b/docs/graph/sites.md
@@ -2,6 +2,10 @@
 
 The search module allows you to access the Microsoft Graph Sites API.
 
+More information can be found in the official Graph documentation:
+
+- [Sites Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/site?view=graph-rest-1.0)
+
 [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  
 
 ## sites

diff --git a/docs/graph/subscriptions.md b/docs/graph/subscriptions.md
@@ -8,6 +8,10 @@ The ability to manage subscriptions is a capability introduced in version 1.2.9
 * Users and Groups from Azure Active Directory.
 * Alerts from the Microsoft Graph Security API.
 
+More information can be found in the official Graph documentation:
+
+- [Subscriptions Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/subscription?view=graph-rest-1.0)
+
 ## Get all of the Subscriptions
 
 Using the subscriptions(). If successful this method returns a 200 OK response code and a list of subscription objects in the response body.

diff --git a/docs/graph/teams.md b/docs/graph/teams.md
@@ -3,6 +3,11 @@
 The ability to manage Team is a capability introduced in the 1.2.7 of @pnp/graph. Through the methods described
 you can add, update and delete items in Teams.
 
+More information can be found in the official Graph documentation:
+
+- [Teams Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/team?view=graph-rest-1.0)
+- [Joined Teams Resource Type](https://docs.microsoft.com/en-us/graph/api/user-list-joinedteams?view=graph-rest-1.0)
+
 ## Teams
 
 ### Teams the user is a member of

diff --git a/docs/graph/users.md b/docs/graph/users.md
@@ -2,7 +2,9 @@
 
 Users are Azure Active Directory objects representing users in the organizations. They represent the single identity for a person across Microsoft 365 services.  
 
-You can learn more about Microsoft Graph users by reading the [Official Microsoft Graph Documentation](https://docs.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0).
+More information can be found in the official Graph documentation:
+
+- [Teams Resource Type](https://docs.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.)
 
 ## IUsers, IUser, IPeople