From fb0eb03fee12ec5af552df75446435863fa75ff4 Mon Sep 17 00:00:00 2001
From: Brad Rogers <brad12rogers@gmail.com>
Date: Fri, 13 May 2022 12:03:58 -0400
Subject: [PATCH] [Documentation] Migrate documentation to docfx

---
 .gitignore                       |   5 +
 doc/StoneDocs.shfbproj           |  95 -------------------
 doc/icons/blue_dropbox_glyph.png | Bin 2376 -> 0 bytes
 doc/styles/branding-Website.css  | 157 -------------------------------
 docfx.json                       |  43 +++++++++
 5 files changed, 48 insertions(+), 252 deletions(-)
 delete mode 100644 doc/StoneDocs.shfbproj
 delete mode 100644 doc/icons/blue_dropbox_glyph.png
 delete mode 100644 doc/styles/branding-Website.css
 create mode 100644 docfx.json

diff --git a/.gitignore b/.gitignore
index 1fccf7400a..0387e95b49 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,8 @@
+# documentation stuff
+obj/
+gh-pages/
+index.md
+
 /dropbox-sdk-dotnet/Dropbox.Api.Integration.Tests/settings.json
 /venv/
 
diff --git a/doc/StoneDocs.shfbproj b/doc/StoneDocs.shfbproj
deleted file mode 100644
index 59b1cb364c..0000000000
--- a/doc/StoneDocs.shfbproj
+++ /dev/null
@@ -1,95 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003" ToolsVersion="14.0">
-  <PropertyGroup>
-    <!-- The configuration and platform will be used to determine which assemblies to include from solution and
-				 project documentation sources -->
-    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
-    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
-    <SchemaVersion>2.0</SchemaVersion>
-    <ProjectGuid>{1e44f241-ec24-4d32-8837-868cbe134f98}</ProjectGuid>
-    <SHFBSchemaVersion>2017.9.26.0</SHFBSchemaVersion>
-    <!-- AssemblyName, Name, and RootNamespace are not used by SHFB but Visual Studio adds them anyway -->
-    <AssemblyName>Documentation</AssemblyName>
-    <RootNamespace>Documentation</RootNamespace>
-    <Name>StoneDocs</Name>
-    <!-- SHFB properties -->
-    <FrameworkVersion>.NET Framework 4.5</FrameworkVersion>
-    <OutputPath>.\Help\</OutputPath>
-    <HtmlHelpName>DotNetApiDocumentation</HtmlHelpName>
-    <Language>en-US</Language>
-    <DocumentationSources>
-      <DocumentationSource sourceFile="..\dropbox-sdk-dotnet\Dropbox.Api\stone_summaries.xml" />
-<DocumentationSource sourceFile="..\dropbox-sdk-dotnet\Dropbox.Api\bin\Release\net45\Dropbox.Api.dll" />
-<DocumentationSource sourceFile="..\dropbox-sdk-dotnet\Dropbox.Api\bin\Release\net45\Dropbox.Api.XML" />
-<DocumentationSource sourceFile="..\dropbox-sdk-dotnet\Dropbox.Api\Generated\namespace_summaries.xml" /></DocumentationSources>
-    <BuildAssemblerVerbosity>OnlyWarningsAndErrors</BuildAssemblerVerbosity>
-    <HelpFileFormat>Website</HelpFileFormat>
-    <IndentHtml>False</IndentHtml>
-    <KeepLogFile>False</KeepLogFile>
-    <DisableCodeBlockComponent>False</DisableCodeBlockComponent>
-    <CppCommentsFixup>False</CppCommentsFixup>
-    <CleanIntermediates>True</CleanIntermediates>
-    <MaximumGroupParts>2</MaximumGroupParts>
-    <NamespaceGrouping>False</NamespaceGrouping>
-    <SyntaxFilters>Standard</SyntaxFilters>
-    <SdkLinkTarget>Blank</SdkLinkTarget>
-    <RootNamespaceContainer>True</RootNamespaceContainer>
-    <PresentationStyle>VS2013</PresentationStyle>
-    <Preliminary>False</Preliminary>
-    <NamingMethod>MemberName</NamingMethod>
-    <HelpTitle>Dropbox API</HelpTitle>
-    <ContentPlacement>AboveNamespaces</ContentPlacement>
-    <NamespaceSummaries>
-    </NamespaceSummaries>
-    <VisibleItems>Protected, EditorBrowsableNever, NonBrowsable</VisibleItems>
-    <RootNamespaceTitle>Dropbox</RootNamespaceTitle>
-    <TransformComponentArguments>
-      <Argument Key="logoFile" Value="blue_dropbox_glyph.png" />
-      <Argument Key="logoHeight" Value="36" />
-      <Argument Key="logoWidth" Value="38" />
-      <Argument Key="logoAltText" Value="" />
-      <Argument Key="logoPlacement" Value="left" />
-      <Argument Key="logoAlignment" Value="left" />
-      <Argument Key="maxVersionParts" Value="2" />
-      <Argument Key="defaultLanguage" Value="cs" />
-    </TransformComponentArguments>
-    <ComponentConfigurations>
-    </ComponentConfigurations>
-    <PostBuildEvent>rmdir Help\toc /S /Q
-rmdir Help\fti /S /Q
-del Help\Search* /Q
-del Help\Web* /Q</PostBuildEvent>
-    <RunPostBuildEvent>OnBuildSuccess</RunPostBuildEvent>
-  </PropertyGroup>
-  <!-- There are no properties for these groups.  AnyCPU needs to appear in order for Visual Studio to perform
-			 the build.  The others are optional common platform types that may appear. -->
-  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
-  </PropertyGroup>
-  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
-  </PropertyGroup>
-  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x86' ">
-  </PropertyGroup>
-  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x86' ">
-  </PropertyGroup>
-  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x64' ">
-  </PropertyGroup>
-  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x64' ">
-  </PropertyGroup>
-  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|Win32' ">
-  </PropertyGroup>
-  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|Win32' ">
-  </PropertyGroup>
-  <ItemGroup>
-    <Folder Include="icons" />
-    <Folder Include="styles" />
-  </ItemGroup>
-  <ItemGroup>
-    <Content Include="icons\blue_dropbox_glyph.png">
-      <ImageId>blue_dropbox_glyph</ImageId>
-      <AlternateText>blue dropbox glyph</AlternateText>
-    </Content>
-    <Content Include="styles\branding-Website.css" />
-  </ItemGroup>
-  <!-- Import the SHFB build targets -->
-  <Import Project="$(SHFBROOT)\SandcastleHelpFileBuilder.targets" />
-</Project>
\ No newline at end of file
diff --git a/doc/icons/blue_dropbox_glyph.png b/doc/icons/blue_dropbox_glyph.png
deleted file mode 100644
index 62fc3399fd68d71c51b95f10fe717686635f7b08..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2376
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

diff --git a/doc/styles/branding-Website.css b/doc/styles/branding-Website.css
deleted file mode 100644
index 1b74758cc8..0000000000
--- a/doc/styles/branding-Website.css
+++ /dev/null
@@ -1,157 +0,0 @@
-/* Style adjustments for websites */
-.pageBody {
-	padding: 0px 20px 0px 0px;
-}
-.topicContent {
-	margin-left: 280px;
-}
-
-/* Lightweight TOC */
-.tocCollapsed {
-	background: url('../icons/TocCollapsed.gif') no-repeat scroll center;
-	width: 17px;
-	height: 20px;
-	overflow: hidden;
-}
-.tocExpanded {
-	background: url('../icons/TocExpanded.gif') no-repeat scroll center;
-	width: 17px;
-	height: 20px;
-	overflow: hidden;
-}
-.tocResize {
-	position: absolute;
-	top: 90px;
-	left: 300px;
-	width: 5px;
-	height: 20px;
-	padding-right: 5px;
-}
-.tocResize img {
-	border: none;
-	cursor: pointer;
-}
-div#leftNav {
-	float: left;
-	margin: 0px -1px 0 0;
-	width: 280px;
-	min-height: 10px;
-	position: relative;
-	border-right: 1px solid #b6b6b6;
-	padding-left: 10px;
-	padding-top: 15px;
-}
-div#tocNav {
-	font-family: 'Segoe UI' ,Verdana,Arial;
-	overflow-x: hidden;
-	line-height: normal;
-	margin: -20px 0 0 -4px;
-}
-div#tocNav > div {
-	overflow-x: hidden;
-	white-space: normal;
-	width: auto;
-	margin-bottom: 5px;
-}
-div#leftNav a, div#leftNav a:link, div#leftNav a:visited {
-	color: #1364c4;
-	text-decoration: none;
-}
-div#leftNav a:hover {
-	color: #3390b1;
-}
-div#tocNav > div > a, div#tocNav > div > a:link, div#tocNav > div > a:visited {
-	display: block;
-	margin-left: 18px;
-	overflow: hidden;
-}
-div#tocNav > div.current > a, div#tocNav > div.current > a:link, div#tocNav > div.current > a:visited {
-	color: #000;
-	font-weight: bold;
-	text-decoration: none;
-}
-div#tocNav > div > a.tocExpanded, div#tocNav > div > a.tocCollapsed {
-	float: left;
-	display: inline-block;
-	margin-left: 0;
-	vertical-align: top;
-}
-div#tocResizableEW {
-	cursor: e-resize;
-	width: 15px;
-	top: 0;
-	height: 100%;
-	position: absolute;
-	display: block;
-	font-size: 0.5px;
-	right: -7px;
-}
-.toclevel0:first-child {
-	margin-top: 16px;
-}
-div#tocNav > div.toclevel1 {
-	padding-left: 17px;
-}
-div#tocNav > div.toclevel2 {
-	padding-left: 34px;
-}
-div#tocNav > div.toclevel3 {
-	padding-left: 51px;
-}
-div#tocNav > div.toclevel4 {
-	padding-left: 68px;
-}
-div#tocNav > div.toclevel5 {
-	padding-left: 85px;
-}
-div#tocNav > div.toclevel6 {
-	padding-left: 102px;
-}
-div#tocNav > div.toclevel7 {
-	padding-left: 119px;
-}
-div#tocNav > div.toclevel8 {
-	padding-left: 136px;
-}
-div#tocNav > div.toclevel9 {
-	padding-left: 153px;
-}
-div#tocNav > div.toclevel10 {
-	padding-left: 170px;
-}
-
-/* Search form */
-form#SearchForm {
-	float: right;
-	background-color: #eee;
-	width: 280px;
-    display: none;
-}
-form#SearchForm input {
-	background-color: #eee;
-	border: 0;
-	height: 22px;
-	width: 230px;
-	color: #3b3b3b;
-	display: inline-block;
-	margin: 1px 0 0 0;
-	padding: 1px 4px 1px 10px;
-}
-form#SearchForm button {
-	background: url('../icons/Search.png') no-repeat scroll center;
-	background-color: #eee;
-	float: right;
-	border: 0;
-	margin: 3px 2px 0 0;
-	cursor: pointer;
-	color: #3b3b3b;
-	width: 19px;
-	height: 18px;
-	overflow: hidden;
-}
-.searchContainer {
-	width: 700px;
-	margin-top: 50px;
-	margin-left: auto;
-	margin-right: auto;
-}
diff --git a/docfx.json b/docfx.json
new file mode 100644
index 0000000000..54a15ce53c
--- /dev/null
+++ b/docfx.json
@@ -0,0 +1,43 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [
+            "dropbox-sdk-dotnet/Dropbox.Api/**.csproj"
+          ],
+          "exclude": [
+            "**/obj/**",
+            "**/bin/**",
+            "gh-pages/**"
+          ]
+        }
+      ],
+      "dest": "obj/api",
+      "properties": {
+          "TargetFramework": "net45"
+      }
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [
+          "obj/api/**.yml"
+        ]
+      },
+      {
+        "files": [
+          "*.md", "toc.yml"
+        ],
+        "exclude": [
+          "gh-pages/**"
+        ]
+      }
+    ],
+    "dest": "gh-pages",
+    "template": [
+      "default"
+    ]
+}
+}
\ No newline at end of file