Repeated entries in navigation

[lcawl]

Describe the bug

Some pages appears twice in the navigation even though they're mentioned only once in the toc.yml file. For example:

I see this happenening in places of the toc like

    - toc: elasticsearch/docs/reference/elasticsearch-plugins

... which references https://github.com/elastic/asciidocalypse/blob/reference/docs/elasticsearch/docs/reference/elasticsearch-plugins/toc.yml

The first file referenced in that toc.yml is shown twice:

toc:
  - file: elasticsearch-plugins.md

I searched on the navigation title just to be sure there wasn't a duplicate file lurking.

Expected behavior

I expected these pages to be used for the section in the navigation, but not to re-appear within that section.

Steps to reproduce

Build the reference branch: https://github.com/elastic/asciidocalypse/tree/reference

Tooling

• docs-builder
• migration tooling
• I'm not sure

[lcawl]

There was a similar problem in the ECS reference section, so I've worked around it for now by bumping that section up a level in the navigation tree in https://github.com/elastic/asciidocalypse/pull/20

[lcawl]

In https://github.com/elastic/asciidocalypse/pull/93 I renamed the first file in the toc.yml to index.md and the problem went away. Is this a hard requirement?

[Mpdreamz]

No this is a bug! we should address it so we don't force everyone to use index.md everywhere which is a terrible experience in editors.

[lcawl]

No this is a bug! we should address it so we don't force everyone to use index.md everywhere which is a terrible experience in editors.

Yay, I've done that to move forward for now but agree it's not ideal.