📝 docs(tfs-work-item-migration-processor): remove deprecated anchor links

- remove redundant anchor links from section headers for cleaner documentation
- improve readability by simplifying the markdown structure

💄 style(docs): enhance TOC and section heading styles

- add optional class data rendering conditionally
- improve table of contents with custom TOC items
- add link icons to section headings for better navigation

💄 style(css): update container styling for responsiveness

- apply media query for container width on larger screens
- improve layout adaptability across different screen sizes

Author: MrHinsh

site/content/docs/reference/processors/tfs-work-item-migration-processor/index.md

@@ -25,7 +25,7 @@ Overall, the `WorkItemMigrationContext` processor is a comprehensive tool for tr
 
 ---
 
-## <a name="WIQLQuery"></a>WIQL Query
+## WIQL Query
 
 The Work Item queries are all built using Work Item [Query Language (WIQL)](https://docs.microsoft.com/en-us/azure/devops/boards/queries/wiql-syntax). We only support flat quereis that have `FROM WorkItems` in the query.
 
@@ -53,11 +53,11 @@ Limit to specific work items (for testing purposes)
 "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.Id] in (123,456,789) AND [System.TeamProject] = @TeamProject AND [System.AreaPath] UNDER 'project\Team 1\' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc"
 ```
 
-## <a name="NodeBasePath"></a>NodeBasePath Configuration
+## NodeBasePath Configuration
 
 Moved to the TfsNodeStructure
 
-# Iteration Maps and Area Maps
+## Iteration Maps and Area Maps
 
 Moved to the TfsNodeStructure
 
@@ -89,6 +89,6 @@ A complete list of [FieldMaps](../FieldMaps/index.md) are available.
 
 > Note: These mappings could also be achieved with other forms of Field mapper e.g. `RegexFieldMapConfig`, but the value mapper as an example is easy to understand
 
-# Removed Properties
+## Removed Properties
 
 - PrefixProjectToNodes - This option was removed in favour of the Area and Iteration Maps on [TfsNodeStructure](/Reference/v2/ProcessorEnrichers/TfsNodeStructure/)

templates/ToolsSite/layouts/docs/single.html

@@ -37,7 +37,10 @@ <h1 class="docs-title">{{ .Title }}</h1>
 
             {{/* Page content */}}
             <div class="docs-body">
-              {{ partial "docs/class-data.html" . }}
+              {{/* Optional class data */}}
+              {{ if .Params.dataFile }}
+                {{ partial "docs/class-data.html" . }}
+              {{ end }}
               {{ .Content }}
             </div>
 
@@ -47,11 +50,27 @@ <h1 class="docs-title">{{ .Title }}</h1>
             </div>
           </div>
         </div>
-
         {{/* Table of contents (optional right sidebar) */}}
         <div class="col-xl-2 d-none d-xl-block">
+          <h5>In this article</h5>
           <div class="docs-toc">
-            {{ .TableOfContents }}
+            <nav>
+              <ul>
+                {{/* Custom TOC items */}}
+                {{ if .Params.dataFile }}
+
+                  <li><a href="#options">Options</a></li>
+                  <li><a href="#examples">Examples</a></li>
+                  <li><a href="#metadata">Metadata </a></li>
+                  <li><hr /></li>
+                {{ end }}
+
+                {{/* Generated TOC */}}
+                {{ if .TableOfContents }}
+                  {{ .TableOfContents | safeHTML }}
+                {{ end }}
+              </ul>
+            </nav>
           </div>
         </div>
       </div>

templates/ToolsSite/layouts/partials/docs/class-data.html

@@ -19,11 +19,14 @@
       <p>{{ $data.description | markdownify }}</p>
     </div>
   {{ end }}
-
   {{/* Render Options as Table */}}
-  {{ if $data.options }}
-    <div class="class-options">
-      <h3>Options</h3>
+  {{ if $data.options }}    <div class="class-options">
+      <h3 id="options" class="position-relative">
+        Options
+        <a href="#options" class="text-decoration-none text-muted ms-2" title="Link to this heading">
+          <i class="fas fa-link fa-sm"></i> 
+        </a>
+      </h3>
       <table class="table table-striped">
         <thead>
           <tr>
@@ -52,14 +55,21 @@ <h3>Options</h3>
       </table>
     </div>
   {{ end }}
-
   {{/* Render Examples */}}
-  {{ if $data.configurationSamples }}
-    <div class="class-examples">
-      <h3>Examples</h3>
-      {{ range $data.configurationSamples }}
-        <div class="example-item">
-          <h4>{{ .name | title }}</h4>
+  {{ if $data.configurationSamples }}    <div class="class-examples">
+      <h3 id="examples" class="position-relative">
+        Examples
+        <a href="#examples" class="text-decoration-none text-muted ms-2" title="Link to this heading">
+          <i class="fas fa-link fa-sm"></i> 
+        </a>
+      </h3>
+      {{ range $data.configurationSamples }}        <div class="example-item">
+          <h4 id="example-{{ anchorize .name }}" class="position-relative">
+            {{ .name | title }}
+            <a href="#example-{{ anchorize .name }}" class="text-decoration-none text-muted ms-2" title="Link to this heading">
+              <i class="fas fa-link fa-sm"></i> 
+            </a>
+          </h4>
           {{ if .description }}
             <p>{{ .description | markdownify }}</p>
           {{ end }}
@@ -70,11 +80,14 @@ <h4>{{ .name | title }}</h4>
       {{ end }}
     </div>
   {{ end }}
-
   {{/* Additional Information */}}
-  {{ if or $data.status $data.processingTarget $data.className }}
-    <div class="class-metadata">
-      <h3>Metadata</h3>
+  {{ if or $data.status $data.processingTarget $data.className }}    <div class="class-metadata">
+      <h3 id="metadata" class="position-relative">
+        Metadata
+        <a href="#metadata" class="text-decoration-none text-muted ms-2" title="Link to this heading">
+          <i class="fas fa-link fa-sm"></i> 
+        </a>
+      </h3>
       <dl class="row">
         {{ if $data.className }}
           <dt class="col-sm-3">Class Name</dt>

templates/ToolsSite/static/css/style.css

@@ -1,5 +1,7 @@
-.container {
-  max-width: 1200px;
+@media (min-width: 1200px) {
+  .container {
+    width: 1200px;
+  }
 }
 
 /* Menu item styling for light and dark themes */