From 20e988af8a0c2e6970ef30a4bb36730b7d1fe4d6 Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Tue, 28 Jan 2025 14:42:56 -0800 Subject: [PATCH 01/14] Experiment --- nodejs/docs-ref-toc/fxtoc.yml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/nodejs/docs-ref-toc/fxtoc.yml b/nodejs/docs-ref-toc/fxtoc.yml index ba69ac3d..a772c1fa 100644 --- a/nodejs/docs-ref-toc/fxtoc.yml +++ b/nodejs/docs-ref-toc/fxtoc.yml @@ -1,7 +1,8 @@ -- name: SDK reference +- name: Reference uid: msteams.sdk.landingPage.reference landingPageType: Root expanded: true href: ~/overview/msteams-client.md children: + - /graph/api/overview - '**' From 7318db8a976cc307b7faaf7be2707ad6f0dc42f9 Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Tue, 28 Jan 2025 14:53:12 -0800 Subject: [PATCH 02/14] Something to force a build --- nodejs/overview/msteams-client.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nodejs/overview/msteams-client.md b/nodejs/overview/msteams-client.md index 0f576da1..733d39e9 100644 --- a/nodejs/overview/msteams-client.md +++ b/nodejs/overview/msteams-client.md @@ -5,7 +5,7 @@ ms.date: 01/17/2025 ms.topic: reference keywords: sdk msteams live-share teamsfx teams client javascript library reference latest --- -# Microsoft Teams SDK reference +# Microsoft Teams Reference There are several libraries available to support various aspects of Teams app development. This article provides an overview of each, along with basic installation instructions. From 658f5bc415f0c1511612393c530091d02b2fa46e Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Tue, 28 Jan 2025 20:25:11 -0800 Subject: [PATCH 03/14] Test --- nodejs/docs-ref-toc/fxtoc.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/nodejs/docs-ref-toc/fxtoc.yml b/nodejs/docs-ref-toc/fxtoc.yml index a772c1fa..fbaa9ed0 100644 --- a/nodejs/docs-ref-toc/fxtoc.yml +++ b/nodejs/docs-ref-toc/fxtoc.yml @@ -5,4 +5,3 @@ href: ~/overview/msteams-client.md children: - /graph/api/overview - - '**' From e65e33e9d9ed56617e5a4837eb553ea46c28c86f Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Tue, 28 Jan 2025 20:43:38 -0800 Subject: [PATCH 04/14] More testing --- nodejs/docs-ref-autogen/manifest/toc.yml | 2 ++ nodejs/docs-ref-autogen/toc.yml | 2 ++ nodejs/docs-ref-toc/fxtoc.yml | 4 ++-- 3 files changed, 6 insertions(+), 2 deletions(-) create mode 100644 nodejs/docs-ref-autogen/manifest/toc.yml diff --git a/nodejs/docs-ref-autogen/manifest/toc.yml b/nodejs/docs-ref-autogen/manifest/toc.yml new file mode 100644 index 00000000..3ec75179 --- /dev/null +++ b/nodejs/docs-ref-autogen/manifest/toc.yml @@ -0,0 +1,2 @@ +- name: 'App manifest reference root' + uid: root \ No newline at end of file diff --git a/nodejs/docs-ref-autogen/toc.yml b/nodejs/docs-ref-autogen/toc.yml index 3ed0a990..85e856a5 100644 --- a/nodejs/docs-ref-autogen/toc.yml +++ b/nodejs/docs-ref-autogen/toc.yml @@ -1,3 +1,5 @@ +- name: 'App manifest reference' + uid: 'manifest/toc.yml' - name: '@microsoft/live-share' items: - name: Overview diff --git a/nodejs/docs-ref-toc/fxtoc.yml b/nodejs/docs-ref-toc/fxtoc.yml index fbaa9ed0..ba69ac3d 100644 --- a/nodejs/docs-ref-toc/fxtoc.yml +++ b/nodejs/docs-ref-toc/fxtoc.yml @@ -1,7 +1,7 @@ -- name: Reference +- name: SDK reference uid: msteams.sdk.landingPage.reference landingPageType: Root expanded: true href: ~/overview/msteams-client.md children: - - /graph/api/overview + - '**' From 02c2504f51fb4fe2f1f26d2736eb46db218e0234 Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Tue, 28 Jan 2025 20:47:45 -0800 Subject: [PATCH 05/14] Try href --- nodejs/docs-ref-autogen/manifest/toc.yml | 2 +- nodejs/docs-ref-autogen/toc.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/nodejs/docs-ref-autogen/manifest/toc.yml b/nodejs/docs-ref-autogen/manifest/toc.yml index 3ec75179..70dd44e7 100644 --- a/nodejs/docs-ref-autogen/manifest/toc.yml +++ b/nodejs/docs-ref-autogen/manifest/toc.yml @@ -1,2 +1,2 @@ - name: 'App manifest reference root' - uid: root \ No newline at end of file + href: /microsoft-365/extensibility/schema/ \ No newline at end of file diff --git a/nodejs/docs-ref-autogen/toc.yml b/nodejs/docs-ref-autogen/toc.yml index 85e856a5..10e5ebb8 100644 --- a/nodejs/docs-ref-autogen/toc.yml +++ b/nodejs/docs-ref-autogen/toc.yml @@ -1,5 +1,5 @@ - name: 'App manifest reference' - uid: 'manifest/toc.yml' + href: 'manifest/toc.yml' - name: '@microsoft/live-share' items: - name: Overview From c334ebd481869cb850365f11a79c5f1ac3278e74 Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Tue, 28 Jan 2025 20:54:18 -0800 Subject: [PATCH 06/14] Progress --- nodejs/docs-ref-autogen/toc.yml | 2 +- nodejs/docs-ref-toc/fxtoc.yml | 4 +++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/nodejs/docs-ref-autogen/toc.yml b/nodejs/docs-ref-autogen/toc.yml index 10e5ebb8..b563f5f1 100644 --- a/nodejs/docs-ref-autogen/toc.yml +++ b/nodejs/docs-ref-autogen/toc.yml @@ -1,4 +1,4 @@ -- name: 'App manifest reference' +- name: 'App manifest' href: 'manifest/toc.yml' - name: '@microsoft/live-share' items: diff --git a/nodejs/docs-ref-toc/fxtoc.yml b/nodejs/docs-ref-toc/fxtoc.yml index ba69ac3d..97a4196a 100644 --- a/nodejs/docs-ref-toc/fxtoc.yml +++ b/nodejs/docs-ref-toc/fxtoc.yml @@ -1,7 +1,9 @@ -- name: SDK reference +- name: Reference uid: msteams.sdk.landingPage.reference landingPageType: Root expanded: true href: ~/overview/msteams-client.md children: + - name: 'App manifest 2' + href: /microsoft-365/extensibility/schema/ - '**' From cd6b60ba90859444d565ef7c8298bd57346d80be Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Tue, 28 Jan 2025 20:58:44 -0800 Subject: [PATCH 07/14] Try again --- nodejs/docs-ref-autogen/manifest/toc.yml | 2 +- nodejs/docs-ref-toc/fxtoc.yml | 2 -- 2 files changed, 1 insertion(+), 3 deletions(-) diff --git a/nodejs/docs-ref-autogen/manifest/toc.yml b/nodejs/docs-ref-autogen/manifest/toc.yml index 70dd44e7..dfa14b3f 100644 --- a/nodejs/docs-ref-autogen/manifest/toc.yml +++ b/nodejs/docs-ref-autogen/manifest/toc.yml @@ -1,2 +1,2 @@ -- name: 'App manifest reference root' +- name: 'App manifest' href: /microsoft-365/extensibility/schema/ \ No newline at end of file diff --git a/nodejs/docs-ref-toc/fxtoc.yml b/nodejs/docs-ref-toc/fxtoc.yml index 97a4196a..e685e156 100644 --- a/nodejs/docs-ref-toc/fxtoc.yml +++ b/nodejs/docs-ref-toc/fxtoc.yml @@ -4,6 +4,4 @@ expanded: true href: ~/overview/msteams-client.md children: - - name: 'App manifest 2' - href: /microsoft-365/extensibility/schema/ - '**' From 7baf352cda5502894e9b6baf93a47db365b8e442 Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Tue, 28 Jan 2025 21:09:55 -0800 Subject: [PATCH 08/14] Variation --- nodejs/docs-ref-autogen/manifest/toc.yml | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/nodejs/docs-ref-autogen/manifest/toc.yml b/nodejs/docs-ref-autogen/manifest/toc.yml index dfa14b3f..6251ef88 100644 --- a/nodejs/docs-ref-autogen/manifest/toc.yml +++ b/nodejs/docs-ref-autogen/manifest/toc.yml @@ -1,2 +1,18 @@ -- name: 'App manifest' - href: /microsoft-365/extensibility/schema/ \ No newline at end of file +- name: Overview + href: /microsoft-365/extensibility/schema/index +- name: App manifest root + href: /microsoft-365/extensibility/schema/root + displayName: root +- name: actions + items: + - name: Overview + href: /microsoft-365/extensibility/schema/element-actions + displayName: elementActions + - name: handlers + items: + - name: Overview + href: /microsoft-365/extensibility/schema/element-actions-handlers + displayName: handlers + - name: botInfo + href: /microsoft-365/extensibility/schema/element-actions-handlers-bot-info + displayName: botInfo From 63d36a6227daad772e89f40e2451788751825ee9 Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Tue, 28 Jan 2025 21:26:08 -0800 Subject: [PATCH 09/14] Testing --- nodejs/docs-ref-autogen/manifest/toc.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/nodejs/docs-ref-autogen/manifest/toc.yml b/nodejs/docs-ref-autogen/manifest/toc.yml index 6251ef88..ea1fc988 100644 --- a/nodejs/docs-ref-autogen/manifest/toc.yml +++ b/nodejs/docs-ref-autogen/manifest/toc.yml @@ -1,12 +1,12 @@ - name: Overview - href: /microsoft-365/extensibility/schema/index + href: /microsoft-365/extensibility/schema/index?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json - name: App manifest root - href: /microsoft-365/extensibility/schema/root + href: /microsoft-365/extensibility/schema/root?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json displayName: root - name: actions items: - name: Overview - href: /microsoft-365/extensibility/schema/element-actions + href: /microsoft-365/extensibility/schema/element-actions?toc=/javascript/api/toc.json displayName: elementActions - name: handlers items: From 239a21ebb63d67a0c1660702cdfb9ed9a60baf7f Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Tue, 28 Jan 2025 22:16:10 -0800 Subject: [PATCH 10/14] More testing --- .../@microsoft/manifest/toc.yml | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 nodejs/docs-ref-autogen/@microsoft/manifest/toc.yml diff --git a/nodejs/docs-ref-autogen/@microsoft/manifest/toc.yml b/nodejs/docs-ref-autogen/@microsoft/manifest/toc.yml new file mode 100644 index 00000000..99d67152 --- /dev/null +++ b/nodejs/docs-ref-autogen/@microsoft/manifest/toc.yml @@ -0,0 +1,18 @@ +- name: Overview 2 + href: /microsoft-365/extensibility/schema/index?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json +- name: App manifest root + href: /microsoft-365/extensibility/schema/root?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json + displayName: root 2 +- name: actions 2 + items: + - name: Overview 2 + href: /microsoft-365/extensibility/schema/element-actions?toc=/javascript/api/toc.json + displayName: elementActions + - name: handlers 2 + items: + - name: Overview 2 + href: /microsoft-365/extensibility/schema/element-actions-handlers + displayName: handlers + - name: botInfo 2 + href: /microsoft-365/extensibility/schema/element-actions-handlers-bot-info + displayName: botInfo From d0c0884ba4b135524499c5df884cef49c19cb7b6 Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Tue, 28 Jan 2025 22:24:49 -0800 Subject: [PATCH 11/14] Remove subfolder --- .../@microsoft/manifest/toc.yml | 18 ------------------ 1 file changed, 18 deletions(-) delete mode 100644 nodejs/docs-ref-autogen/@microsoft/manifest/toc.yml diff --git a/nodejs/docs-ref-autogen/@microsoft/manifest/toc.yml b/nodejs/docs-ref-autogen/@microsoft/manifest/toc.yml deleted file mode 100644 index 99d67152..00000000 --- a/nodejs/docs-ref-autogen/@microsoft/manifest/toc.yml +++ /dev/null @@ -1,18 +0,0 @@ -- name: Overview 2 - href: /microsoft-365/extensibility/schema/index?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json -- name: App manifest root - href: /microsoft-365/extensibility/schema/root?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json - displayName: root 2 -- name: actions 2 - items: - - name: Overview 2 - href: /microsoft-365/extensibility/schema/element-actions?toc=/javascript/api/toc.json - displayName: elementActions - - name: handlers 2 - items: - - name: Overview 2 - href: /microsoft-365/extensibility/schema/element-actions-handlers - displayName: handlers - - name: botInfo 2 - href: /microsoft-365/extensibility/schema/element-actions-handlers-bot-info - displayName: botInfo From ad9cf364398d28758bf536d8bf3e8585e3996f1c Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Tue, 28 Jan 2025 22:35:24 -0800 Subject: [PATCH 12/14] More fixes --- nodejs/breadcrumb/toc.yml | 8 ++------ nodejs/docs-ref-autogen/manifest/toc.yml | 6 +++--- 2 files changed, 5 insertions(+), 9 deletions(-) diff --git a/nodejs/breadcrumb/toc.yml b/nodejs/breadcrumb/toc.yml index 381caeec..ae92b553 100644 --- a/nodejs/breadcrumb/toc.yml +++ b/nodejs/breadcrumb/toc.yml @@ -1,7 +1,3 @@ - name: Microsoft Teams - tocHref: / - topicHref: /microsoftteams/ - items: - - name: Developer platform - tocHref: /javascript/api/ - topicHref: /microsoftteams/platform/index + tocHref: /microsoftteams/ + topicHref: /microsoftteams/ \ No newline at end of file diff --git a/nodejs/docs-ref-autogen/manifest/toc.yml b/nodejs/docs-ref-autogen/manifest/toc.yml index ea1fc988..378a9140 100644 --- a/nodejs/docs-ref-autogen/manifest/toc.yml +++ b/nodejs/docs-ref-autogen/manifest/toc.yml @@ -6,13 +6,13 @@ - name: actions items: - name: Overview - href: /microsoft-365/extensibility/schema/element-actions?toc=/javascript/api/toc.json + href: /microsoft-365/extensibility/schema/element-actions?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json displayName: elementActions - name: handlers items: - name: Overview - href: /microsoft-365/extensibility/schema/element-actions-handlers + href: /microsoft-365/extensibility/schema/element-actions-handlers?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json displayName: handlers - name: botInfo - href: /microsoft-365/extensibility/schema/element-actions-handlers-bot-info + href: /microsoft-365/extensibility/schema/element-actions-handlers-bot-info?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json displayName: botInfo From c7197f60f760fa14c012a7861414156b33bdc845 Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Wed, 5 Mar 2025 12:19:44 -0800 Subject: [PATCH 13/14] Simple experiment --- nodejs/docs-ref-autogen/toc.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nodejs/docs-ref-autogen/toc.yml b/nodejs/docs-ref-autogen/toc.yml index b563f5f1..032afd6d 100644 --- a/nodejs/docs-ref-autogen/toc.yml +++ b/nodejs/docs-ref-autogen/toc.yml @@ -1,5 +1,5 @@ - name: 'App manifest' - href: 'manifest/toc.yml' + href: '/microsoft-365/extensibility/schema' - name: '@microsoft/live-share' items: - name: Overview From c7a1b53931a6ac23a40e1928a24b897dcdb3a36a Mon Sep 17 00:00:00 2001 From: Erika Doyle Navara Date: Wed, 5 Mar 2025 13:55:41 -0800 Subject: [PATCH 14/14] Add section for app manifest --- nodejs/overview/msteams-client.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/nodejs/overview/msteams-client.md b/nodejs/overview/msteams-client.md index 733d39e9..151af388 100644 --- a/nodejs/overview/msteams-client.md +++ b/nodejs/overview/msteams-client.md @@ -9,15 +9,20 @@ keywords: sdk msteams live-share teamsfx teams client javascript library referen There are several libraries available to support various aspects of Teams app development. This article provides an overview of each, along with basic installation instructions. -| Library | Description | API reference | +| Resource | Description | Reference | |-|-|-| +| **App manifest** | App manifest describes the functionality and configuration of your app. | [Microsoft 365 app manifest schema reference](/microsoft-365/extensibility/schema) | | **Live Share SDK** | Live Share enables collaborative app experiences | [Live Share](../docs-ref-autogen/%40microsoft/live-share/index.yml)

[Live Share canvas](../docs-ref-autogen/%40microsoft/live-share-canvas/index.yml)

[Live Share media](../docs-ref-autogen/%40microsoft/live-share-media/index.yml) | | **TeamsJS library** | Teams JavaScript client library enables you to create hosted experiences in Teams, Outlook, and the Microsoft 365 app | [TeamsJS ](../docs-ref-autogen/%40microsoft/teams-js/index.yml) | | **TeamsFx SDK** | TeamsFx helps to reduce tasks by using Microsoft Teams single sign-on (SSO) and accessing cloud resources down to single line statements with little configuration | [Teamsfx](../docs-ref-autogen/%40microsoft/teamsfx/index.yml) | +## App manifest + +App manifest is a JSON file that describes the functionality and configuration of your app, and how it integrates with Microsoft 365 products, including Microsoft 365 Copilot, Teams, Outlook, and more. App manifest is a key component of the unified [Microsoft 365 app package](/microsoft-365/extensibility/schema), with which you can submit Microsoft 365 Copilot agents, Teams apps, SharePoint Framework apps, Graph connectors, and Office Add-ins to the *Microsoft 365 and Copilot* program in Microsoft Partner Center as a Store offer, or directly to your organization's app catalog. You can also use the public [developer preview](/microsoftteams/platform/resources/schema/manifest-schema-dev-preview) schema to try out platform features in development. + ## Microsoft Teams Live Share -The [Live Share SDK](https://github.com/microsoft/live-share-sdk) is comprised of three sub-packages with features to help developers create more collaborative moments across Microsoft Teams. Live Share (sometimes called *Live Share core*) is for connecting to Fluid Framework through `sidePanel` and `meetingStage` for in meeting pop-up cards. *Live Share media* allows for media synchronization of video and audio during a Teams session. *Live Share canvas* adds annotation tools for whiteboard and PowerPoint presentations. +The [Live Share SDK](https://github.com/microsoft/live-share-sdk) is comprised of three sub-packages with features to help developers create more collaborative moments across Microsoft Teams. Live Share (sometimes called *Live Share core*) is for connecting to Fluid Framework through `sidePanel` and `meetingStage` for in meeting pop-up cards. *Live Share media* allows for media synchronization of video and audio during a Teams session. *Live Share canvas* adds annotation tools for whiteboard and PowerPoint presentations. ### Finding the library