Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

'Section index pages' selects 'README.md' as well as 'index.md'. But it is not documented #5086

Closed
2 tasks done
ndy2 opened this issue Feb 23, 2023 · 1 comment
Closed
2 tasks done
Labels
documentation Issue concerns the documentation

Comments

@ndy2
Copy link

ndy2 commented Feb 23, 2023

Description

In the documentation of Section index pages feature, it says that index.md in respective folder would selected as a top level document for the folder. But I found that README.md also selected as a top level document.

with the feature navigation.indexes enabled

.folder
├── 1.md
├── 2.md
└── README.md

results in rendered navigation

.folder -> README.md
├── 1.md
└── 2.md

Related links

Proposed change

Add 'README.md' to Section index pages documentation.

I found that if both README.md and index.md supplied the README.md file get disappeared as documented in above mkdocs link. This is not specified to this feature, but I think it can be documented here.

Before submitting

@ndy2 ndy2 added the documentation Issue concerns the documentation label Feb 23, 2023
@squidfunk
Copy link
Owner

squidfunk commented Feb 26, 2023

Thanks for reporting! Added in f3ae326 as a code annotation.

Bildschirmfoto 2023-02-26 um 11 48 42

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Issue concerns the documentation
Projects
None yet
Development

No branches or pull requests

2 participants