Slight confusion over a new disambiguation warning (6.1/main dev branch)

Development Swift-DocC
1

There's a new disambiguation warning in the DocC output on the main line branch that I was hoping to get some help on. This is from the swift-markdown project (where I was cleaning up some random little bits of docs - parameter mismatches and such). The warning:

warning: 'Snippets' is ambiguous at '/Markdown'
  --> Markdown.md:17:8-17:16
15 | A quick overview of examples showing tasks you can achieve with Swift Markdown.
16 |
17 + - <doc:Snippets>
   |                ├─suggestion: Insert 'anchor' for'Snippets'
   |                ╰─suggestion: Insert 'article' for'Snippets'
18 |
19 | ### Getting Started

warning: 'Infrastructure' is ambiguous at '/Markdown'
  --> Markdown.md:44:8-44:22
42 | ### Infrastructure
43 |
44 + - <doc:Infrastructure>
   |                      ├─suggestion: Insert 'anchor' for'Infrastructure'
   |                      ╰─suggestion: Insert 'article' for'Infrastructure'
45 |
46 | ### Visit MarkupFinished building documentation for 'Markdown' (1.19s)

I'm taking from this that DocC is interpreting Infrastructure has two possible symbols that it could link against, and isn't a unique by itself. I'd fully expected "article", but what is the anchor symbol that it's matching? Is that the heading just above there (on line 42) that its being confused about referencing - either that or the article?

1 Like
2

@ronnqvist when you have a moment, could you take a look and and help me understand the variations on the suggestions that the newer DocC is making in terms of disambiguations?