Topic/update docs 2 (#2319)

Update layouts
nkdAgility · Sep 2, 2024 · 02994fe · 02994fe
2 parents 60146fe + b91e6ae
commit 02994fe
Show file tree

Hide file tree

Showing 12 changed files with 227 additions and 184 deletions.
diff --git a/docs/Reference/Generated/MigrationTools.xml b/docs/Reference/Generated/MigrationTools.xml
diff --git a/docs/Reference/ReflectedWorkItemId.md b/docs/Reference/ReflectedWorkItemId.md
diff --git a/docs/_includes/sidebar.html b/docs/_includes/sidebar.html
@@ -1,12 +1,21 @@
 <div class="flex-shrink-0 p-3" style="width: 280px;">
     <ul class="bd-links-nav list-unstyled mb-0 pb-3 pb-md-2 pe-lg-2">
+        <li><a href="{{site.baseurl}}/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Overview</a></li>
+        <li><hr /></li>
+        <li class="mb-1">
+            <strong class="bd-links-heading d-flex w-100 align-items-center fw-semibold">Setup</strong>
+            <ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small ps-2">
+                <li><a href="{{site.baseurl}}/setup/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Overview</a></li>
+                <li><a href="{{site.baseurl}}/setup/installation/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Installation</a></li>
+                <li><a href="{{site.baseurl}}/setup/permissions/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Permissions</a></li>
+                <li><a href="{{site.baseurl}}/setup/reflectedworkItemid/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">ReflectedWorkItemId</a></li>
+            </ul>
+        </li>
+        <li><hr /></li>
         <li class="mb-1">
             <strong class="bd-links-heading d-flex w-100 align-items-center fw-semibold">Getting Started</strong>
             <ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small ps-2">
-                <li><a href="{{site.baseurl}}/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Overview</a></li>
-                <li><a href="{{site.baseurl}}/getting-started/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Getting Started</a></li>
-                <li><a href="{{site.baseurl}}/installation/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Installation</a></li>
-                <li><a href="{{site.baseurl}}/permissions/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Permissions</a></li>
+                <li><a href="{{site.baseurl}}/getting-started/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Overview</a></li>
                 <li><a href="{{site.baseurl}}/version-control/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Version Control</a></li>
             </ul>
         </li>
@@ -31,7 +40,6 @@
             <ul class="bd-links-nav list-unstyled mb-0 pb-3 pb-md-2 pe-lg-2 ps-2">
                 <ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small ps-2">
                     <li class="align-items-center"><a href="{{ site.baseurl }}/Reference/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Overview</a></li>
-                    <li class="align-items-center"><a href="{{ site.baseurl }}/Reference/reflectedworkItemid/" class="link-body-emphasis d-inline-flex text-decoration-none rounded">ReflectedWorkItemId</a></li>
                     <li><hr /></li>
                     {% include sidebar-collection-reference.html collection = "reference" typeName = "Processors" %}
                     {% include sidebar-collection-reference.html collection = "reference" typeName = "Endpoints" %}

diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html
@@ -41,7 +41,7 @@
                     </div>
                 </article>
             </div>
-            <div class="p-2 flex-fill d-none d-xl-block" style="min-width: 15vw;">
+            <div class="p-2 flex-fill d-none d-xl-block" style="min-width: 15vw;max-width: 20vw;">
                 <div class="card mb-3">
                     <img src="{{ site.baseurl }}/assets/images/Azure-DevOps-Migration-Tools-GithubSocial-Image.jpg" class="card-img-top" alt="...">
                     <div class="card-body">
@@ -63,7 +63,6 @@
                         </ul>
                     </div>
                 </div>
-                {% include cardpanel-contribute.html expand = true %}
                 <div class="card mb-3">
                     <h5 class="no_toc card-header">Getting Support</h5>
                     <div class="card-body">
@@ -78,9 +77,34 @@ <h5 class="no_toc card-header">Getting Support</h5>
                     <h5 class="no_toc card-header">In this article</h5>
                     <div class="card-body">
                         {{ content | toc_only }}
+                        <div class="container mt-5">
+                            <ul class="list-group">
+                                <li class="list-group-item">
+                                    <i class="fas fa-question-circle"></i> 
+                                    <a href="https://github.com/nkdAgility/azure-devops-migration-tools/discussions/categories/q-a" class="ml-2"target="_blank">Ask Questions</a>
+                                </li>
+                                <li class="list-group-item">
+                                    <i class="fab fa-twitter"></i> 
+                                    <a href="https://x.com/nkdagility" class="ml-2"target="_blank">Twitter Follow</a>
+                                </li>
+                                <li class="list-group-item">
+                                    <i class="fas fa-cogs"></i> 
+                                    <a href="https://github.com/nkdAgility/azure-devops-migration-tools/discussions/categories/ideas" class="ml-2"target="_blank">Features</a>
+                                </li>
+                                <li class="list-group-item">
+                                    <i class="fas fa-exclamation-circle"></i> 
+                                    <a href="https://github.com/nkdAgility/azure-devops-migration-tools/discussions/categories/general" class="ml-2"target="_blank">Issues</a>
+                                </li>
+                                <li class="list-group-item">
+                                    <i class="fas fa-video"></i> 
+                                    <a href="https://www.youtube.com/playlist?list=PLQEC_R53iJWPok6OtYcavAlE9xKnZzgGK" class="ml-2" target="_blank">Videos</a>
+                                </li>
+                            </ul>
+                        </div>
                     </div>
                 </div>
                 {% endif %}
+                {% include cardpanel-contribute.html expand = true %}
             </div>
 
         </div>

diff --git a/docs/getting-started.md → docs/getstarted/index.md b/docs/getting-started.md → docs/getstarted/index.md
@@ -5,6 +5,8 @@ pageType: index
 toc: true
 pageStatus: published
 discussionId: 
+redirect_from:
+  - /getting-started/
 ---
 
 If you want to perform a bulk edit or a migration then you need to start here. This tool has been tested on updating from 100 to 250,000 work items by its users.

diff --git a/docs/getstarted/introvideos.md b/docs/getstarted/introvideos.md
@@ -0,0 +1,10 @@
+---
+title: Introductory Videos
+layout: page
+pageType: index
+toc: true
+pageStatus: published
+discussionId: 
+---
+
+- [Video Overview](https://youtu.be/RCJsST0xBCE)
diff --git a/docs/index.md b/docs/index.md
@@ -3,7 +3,7 @@ title: Azure DevOps Migration Tools
 layout: page
 pageType: index
 template: index-template.md
-toc: true
+toc: false
 pageStatus: published
 discussionId: 
 ---
@@ -62,10 +62,6 @@ For the most part we support moving data between `((Azure DevOps Server | Team F
 - [Community Support](https://github.com/nkdAgility/azure-devops-migration-tools/discussions)
 - [Commercial Support](https://nkdagility.com/capabilities/azure-devops-migration-services/)
 
-## Tutorials
-
-- [Video Overview](https://youtu.be/RCJsST0xBCE)
-
 The documentation for the preview is on [Preview](https://nkdagility.com/docs/azure-devops-migration-tools/preview/)]
 
 #### External Walkthroughs and Reviews

diff --git a/docs/permissions.md b/docs/permissions.md