Updated documentation generation (#80)

* Reworked Documentation generation

* Updated Readme links

Author: 4thlabs

Readme.md

@@ -37,7 +37,7 @@ dotnet add package DolbyIO.Comms.Sdk
 
 #### 1. Initialize the SDK
 
-Initialize the SDK using the secure authentication method that uses a token in the application. For the purpose of this application, use a [client access token](https://docs.dolby.io/communications-apis/docs/overview-developer-tools#client-access-token) generated from the Dolby.io dashboard. Use the following code to initialize the SDK using the [DolbyIOSDK.InitAsync](https://api-references.dolby.io/comms-sdk-dotnet/documentation/api/DolbyIO.Comms.DolbyIOSDK.html#DolbyIO_Comms_DolbyIOSDK_InitAsync_System_String_DolbyIO_Comms_RefreshTokenCallBack_) method:
+Initialize the SDK using the secure authentication method that uses a token in the application. For the purpose of this application, use a [client access token](https://docs.dolby.io/communications-apis/docs/overview-developer-tools#client-access-token) generated from the Dolby.io dashboard. Use the following code to initialize the SDK using the [DolbyIOSDK.InitAsync](https://api-references.dolby.io/comms-sdk-dotnet/api/DolbyIO.Comms.DolbyIOSDK.html#DolbyIO_Comms_DolbyIOSDK_InitAsync_System_String_DolbyIO_Comms_RefreshTokenCallBack_) method:
 
 ```cs
 using DolbyIO.Comms;
@@ -58,7 +58,7 @@ catch (DolbyIOException e)
 }
 ```
 
-**NOTE:** The SDK is fully asynchronous, and all methods can throw the [DolbyIOException](https://api-references.dolby.io/comms-sdk-dotnet/documentation/api/DolbyIO.Comms.DolbyIOException.html).
+**NOTE:** The SDK is fully asynchronous, and all methods can throw the [DolbyIOException](https://api-references.dolby.io/comms-sdk-dotnet/api/DolbyIO.Comms.DolbyIOException.html).
 
 #### 2. Register event handlers
 
@@ -82,7 +82,7 @@ _sdk.Conference.ParticipantAdded = new ParticipantAddedEventHandler
 
 A session is a connection between the client application and the Dolby.io backend. When opening a session, you should provide a name. Commonly, this is the name of the participant who established the session. The session can remain active for the whole lifecycle of your application. 
 
-To open a new session, use the [Session.OpenAsync](https://api-references.dolby.io/comms-sdk-dotnet/documentation/api/DolbyIO.Comms.Services.SessionService.html#DolbyIO_Comms_Services_SessionService_OpenAsync_DolbyIO_Comms_UserInfo_) method as in the following example:
+To open a new session, use the [Session.OpenAsync](https://api-references.dolby.io/comms-sdk-dotnet/api/DolbyIO.Comms.Services.SessionService.html#DolbyIO_Comms_Services_SessionService_OpenAsync_DolbyIO_Comms_UserInfo_) method as in the following example:
 
 ```cs
 try
@@ -102,7 +102,7 @@ catch (DolbyIOException e)
 
 A conference is a multi-person call where participants exchange audio with one another. To distinguish between multiple conferences, you should assign a conference alias or name. When multiple participants join a conference of the same name using a token of the same Dolby.io application, they will be able to meet in a call.
 
-To create and join a conference, use the [Conference.CreateAsync](hhttps://api-references.dolby.io/comms-sdk-dotnet/documentation/api/DolbyIO.Comms.Services.ConferenceService.html#DolbyIO_Comms_Services_ConferenceService_CreateAsync_DolbyIO_Comms_ConferenceOptions_) and [Conference.JoinAsync](https://api-references.dolby.io/comms-sdk-dotnet/documentation/api/DolbyIO.Comms.Services.ConferenceService.html#DolbyIO_Comms_Services_ConferenceService_JoinAsync_DolbyIO_Comms_Conference_DolbyIO_Comms_JoinOptions_) methods as in the following example:
+To create and join a conference, use the [Conference.CreateAsync](hhttps://api-references.dolby.io/comms-sdk-dotnet/api/DolbyIO.Comms.Services.ConferenceService.html#DolbyIO_Comms_Services_ConferenceService_CreateAsync_DolbyIO_Comms_ConferenceOptions_) and [Conference.JoinAsync](https://api-references.dolby.io/comms-sdk-dotnet/api/DolbyIO.Comms.Services.ConferenceService.html#DolbyIO_Comms_Services_ConferenceService_JoinAsync_DolbyIO_Comms_Conference_DolbyIO_Comms_JoinOptions_) methods as in the following example:
 
 ```cs
 try
@@ -121,11 +121,11 @@ catch (DolbyIOException e)
 }
 ```
 
-If the conference already exists, the SDK returns [Conference](https://api-references.dolby.io/comms-sdk-dotnet/documentation/api/DolbyIO.Comms.Conference).
+If the conference already exists, the SDK returns [Conference](https://api-references.dolby.io/comms-sdk-dotnet/api/DolbyIO.Comms.Conference).
 
 #### 5. Leave the conference
 
-To leave the conference, use the [Conference.LeaveAsync](https://api-references.dolby.io/comms-sdk-dotnet/documentation/api/DolbyIO.Comms.Services.ConferenceService.html#DolbyIO_Comms_Services_ConferenceService_LeaveAsync) method, as in the following example:
+To leave the conference, use the [Conference.LeaveAsync](https://api-references.dolby.io/comms-sdk-dotnet/api/DolbyIO.Comms.Services.ConferenceService.html#DolbyIO_Comms_Services_ConferenceService_LeaveAsync) method, as in the following example:
 
 ```cs
 try
@@ -140,7 +140,7 @@ catch (DolbyIOException e)
 
 #### 6. Close the session and dispose of the SDK
 
-After leaving the conference, close the session and dispose the SDK using the [Session.CloseAsync](https://api-references.dolby.io/comms-sdk-dotnet/documentation/api/DolbyIO.Comms.Services.SessionService.html#DolbyIO_Comms_Services_SessionService_CloseAsync) and [DolbyIOSDK.Dispose](https://api-references.dolby.io/comms-sdk-dotnet/documentation/api/DolbyIO.Comms.DolbyIOSDK.html#DolbyIO_Comms_DolbyIOSDK_Dispose) methods.
+After leaving the conference, close the session and dispose the SDK using the [Session.CloseAsync](https://api-references.dolby.io/comms-sdk-dotnet/api/DolbyIO.Comms.Services.SessionService.html#DolbyIO_Comms_Services_SessionService_CloseAsync) and [DolbyIOSDK.Dispose](https://api-references.dolby.io/comms-sdk-dotnet/api/DolbyIO.Comms.DolbyIOSDK.html#DolbyIO_Comms_DolbyIOSDK_Dispose) methods.
 
 ```cs
 try

docs/documentation/api/.gitignore renamed to docs/api/.gitignore

@@ -9,7 +9,7 @@
           "src": "../"
         }
       ],
-      "dest": "documentation/api",
+      "dest": "api",
       "disableGitFeatures": false,
       "disableDefaultFilter": false,
       "filter": "filterConfig.yml"
@@ -19,8 +19,8 @@
     "content": [
       {
         "files": [
-          "documentation/api/**.yml",
-          "documentation/api/index.md"
+          "api/**.yml",
+          "api/index.md"
         ]
       },
       {

docs/docfx.json

@@ -1,10 +1,6 @@
-- name: Overview
-  href: index.md
 - name: Getting Started
   href: started.md
 - name: Unity Plugin
   href: unity.md
 - name: Unity Visual Scripting
   href: visualscripting.md
-- name: Api Reference
-  href: api/toc.yml

docs/documentation/toc.yml

@@ -0,0 +1,5 @@
+# Dolby.io Communications .NET SDK
+
+The Dolby.io Communications .NET SDK allows creating high-quality applications for conferencing, streaming, and collaborating. With the .NET SDK you can easily integrate the HD Dolby Voice experience, including spatial audio and shared scenes, into game engines and virtual spaces.
+
+The SDK depends on the C++ SDK for core functions and supports the same functionalities for client applications as the C++ SDK.

docs/index.md

@@ -1,3 +1,5 @@
 - name: .NET SDK Documentation
   href: documentation/
-  homepage: documentation/index.md
+  homepage: documentation/started.md
+- name: Api Reference
+  href: api/