Directories with a single index.md file require special docset.yml pattern

[bmorelli25]

Describe the bug

With the following directory structure:

I'd expect to use this pattern to include files in docset.yml:

    - file: reference/1password/index.md
    - file: reference/abnormal_security/index.md
    - file: reference/activemq/index.md
    - file: reference/entityanalytics_ad/index.md
    - file: reference/admin_by_request_epm/index.md
    - file: reference/airflow/index.md
    - file: reference/akamai/index.md

However, following this pattern results in all of the above pages being silently excluded from the table of contents:

Instead, the following pattern had be used to get the files to build to the table of contents:

  - file: reference/1password.md
  - file: reference/abnormal_security.md
  - file: reference/activemq.md
  - file: reference/entityanalytics_ad.md
  - file: reference/admin_by_request_epm.md
  - file: reference/airflow.md
  - file: reference/akamai.md

Here's the PR where @colleenmcginnis is working on this content: https://github.com/elastic/integration-docs/pull/688.

This is potentially related to #443?

Expected behavior

I should be able to use the full path to include these files.

Steps to reproduce

see above

Tooling

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

[Mpdreamz]

Can you try:

- folder: reference/1password
- folder: reference/abnormal_security
- folder: reference/activemq
- folder: reference/entityanalytics_ad
- folder: reference/admin_by_request_epm
- folder: reference/airflow
- folder: reference/akamai

[colleenmcginnis]

Ok I got it to work with your suggestion (https://github.com/elastic/integration-docs/pull/688/commits/736ab13a72cf578e2ce2553b6e64fa52a9bf3629). Thanks @Mpdreamz!

(I just manually edited docset.yml to test this. I still have to figure out how to update the logic that builds the integration docs docset.yml file so the output works.)

[colleenmcginnis]

In the integration docs, I used Martijn's suggestion above (using folder) and it worked BUT the items in the nav are still styled as if they contain multiple subpages.

[theletterf]

Just run into the same problem. Can be solved through the folder workaround, though it's kind of counterintuitive.