✨ feat(docs): add comments support to documentation

- introduce giscus comments integration for documentation pages
- create a reusable partial for comments to streamline code maintenance

♻️ refactor(docs): use markdownify for descriptions

- apply markdownify to descriptions for consistent text formatting

Author: MrHinsh

docs/layouts/_partials/docs/comments.html

@@ -0,0 +1,19 @@
+<script
+src="https://giscus.app/client.js"
+data-repo="nkdAgility/azure-devops-migration-tools"
+data-repo-id="MDEwOlJlcG9zaXRvcnk1NjMxOTA3MA=="
+data-category-id="DIC_kwDOA1tcXs4Cj0cn"
+{{ if .Params.discussionId }}
+data-mapping="number" data-term="{{ .Params.discussionId }}"
+{{ else }}
+data-mapping="og:title" data-strict="1"
+{{ end }}
+data-reactions-enabled="1"
+data-emit-metadata="0"
+data-input-position="bottom"
+data-theme="light_protanopia"
+data-lang="en"
+data-loading="lazy"
+crossorigin="anonymous"
+async>
+</script>

docs/layouts/docs/list.html

@@ -44,7 +44,7 @@ <h5 class="card-title">
                                 {{ .Title }}
                               </a>
                             </h5>
-                              <p class="card-text text-muted">{{ .Description }}</p>
+                              <p class="card-text text-muted">{{ .Description | markdownify }}</p>
 
                             {{/* Show child pages count */}}
                             {{ if .Pages }}
@@ -83,6 +83,8 @@ <h5 class="card-title">
                 {{ .Content | markdownify }}
               </div>
 
+             
+
               {{/* Getting started section */}}
               {{ $gettingStarted := .Site.GetPage "/docs/get-started/getting-started/" }}
               {{ if $gettingStarted }}
@@ -100,6 +102,10 @@ <h4 class="alert-heading">
                   </div>
                 </div>
               {{ end }}
+
+               <div class="docs-comments">
+                {{ partial "docs/comments.html" . }}
+              </div>
             </div>
           </div>
         </div>

docs/layouts/docs/single.html

@@ -60,25 +60,8 @@ <h1 class="docs-title">{{ .Title }}</h1>
                 {{ .Content }}
               </div>
 
-              <div class="docs-commnets">
-                <script
-                  src="https://giscus.app/client.js"
-                  data-repo="nkdAgility/azure-devops-migration-tools"
-                  data-repo-id="MDEwOlJlcG9zaXRvcnk1NjMxOTA3MA=="
-                  data-category-id="DIC_kwDOA1tcXs4Cj0cn"
-                  {{ if .Params.discussionId }}
-                    data-mapping="number" data-term="{{ .Params.discussionId }}"
-                  {{ else }}
-                    data-mapping="og:title" data-strict="1"
-                  {{ end }}
-                  data-reactions-enabled="1"
-                  data-emit-metadata="0"
-                  data-input-position="bottom"
-                  data-theme="light_protanopia"
-                  data-lang="en"
-                  data-loading="lazy"
-                  crossorigin="anonymous"
-                  async></script>
+              <div class="docs-comments">
+                {{ partial "docs/comments.html" . }}
               </div>
 
               {{/* Page navigation */}}