Fix errors

Author: theletterf

docs/_docset.yml

@@ -149,5 +149,7 @@ toc:
           - folder: baz
             children:
               - file: qux.md
-  - title: "Getting Started Guide"
-    crosslink: docs-content://get-started/introduction.md
+      - title: "Getting Started Guide"
+        crosslink: docs-content://get-started/introduction.md
+      - title: "Test title"
+        crosslink: docs-content://solutions/search/elasticsearch-basics-quickstart.md

docs/configure/content-set/navigation.md

@@ -72,12 +72,38 @@ cross_links:
   - docs-content
 ```
 
+#### Adding cross-links in Markdown content
+
 To link to a document in the `docs-content` repository, you would write the link as follows:
 
-```
+```markdown
 [Link to docs-content doc](docs-content://directory/another-directory/file.md)
 ```
 
+You can also link to specific anchors within the document:
+
+```markdown
+[Link to specific section](docs-content://directory/file.md#section-id)
+```
+
+#### Adding cross-links in navigation
+
+Cross-links can also be included in navigation structures. When creating a `toc.yml` file or defining navigation in `docset.yml`, you can add cross-links as follows:
+
+```yaml
+toc:
+  - file: index.md
+  - title: External Documentation
+    cross_link: docs-content://directory/file.md
+  - folder: local-section
+    children:
+      - file: index.md
+      - title: API Reference
+        cross_link: elasticsearch://api/index.html
+```
+
+Cross-links in navigation will be automatically resolved during the build process, maintaining consistent linking between related documentation across repositories.
+
 ### `exclude`
 
 Files to exclude from the TOC. Supports glob patterns.

tests/Elastic.Markdown.Tests/TestCrossLinkResolver.cs

@@ -19,6 +19,10 @@ public class TestCrossLinkResolver : ICrossLinkResolver
 
 	public Task<FetchedCrossLinks> FetchLinks(Cancel ctx)
 	{
+		// Clear existing entries to prevent duplicate key errors when called multiple times
+		LinkReferences.Clear();
+		DeclaredRepositories.Clear();
+
 		// language=json
 		var json = """
 		           {
@@ -47,7 +51,7 @@ public Task<FetchedCrossLinks> FetchLinks(Cancel ctx)
 		var reference = CrossLinkFetcher.Deserialize(json);
 		LinkReferences.Add("docs-content", reference);
 		LinkReferences.Add("kibana", reference);
-		DeclaredRepositories.AddRange(["docs-content", "kibana", "elasticsearch"]);
+		DeclaredRepositories.AddRange(["docs-content", "kibana"]);
 
 		var indexEntries = LinkReferences.ToDictionary(e => e.Key, e => new LinkRegistryEntry
 		{

tests/authoring/Framework/TestCrossLinkResolver.fs

@@ -28,6 +28,10 @@ type TestCrossLinkResolver (config: ConfigurationFile) =
         member this.UriResolver = uriResolver
 
         member this.FetchLinks(ctx) =
+            // Clear existing entries to prevent duplicate key errors when called multiple times
+            this.LinkReferences.Clear()
+            this.DeclaredRepositories.Clear()
+            
             let redirects = RepositoryLinks.SerializeRedirects config.Redirects
             // language=json
             let json = $$"""{
@@ -66,7 +70,6 @@ type TestCrossLinkResolver (config: ConfigurationFile) =
             this.LinkReferences.Add("kibana", reference)
             this.DeclaredRepositories.Add("docs-content") |> ignore;
             this.DeclaredRepositories.Add("kibana") |> ignore;
-            this.DeclaredRepositories.Add("elasticsearch") |> ignore
 
             let indexEntries =
                 this.LinkReferences.ToDictionary(_.Key, fun (e : KeyValuePair<string, RepositoryLinks>) -> LinkRegistryEntry(