Allow mkdocs.yaml when '--config' is not passed#2206
Allow mkdocs.yaml when '--config' is not passed#2206hwmrocker wants to merge 3 commits intomkdocs:masterfrom
Conversation
|
If you like this PR I would appreciate when you add the |
|
Interesting patch. While I understand why some might want this, I'm not sure I like the idea. The file extension is clearly documented. So just use the correct extension. I'll have to think about this. In any event, at a minimum, this would need a note added to the release notes. |
|
Of course, I added a line to the release notes. Hope this is the correct way to do so. |
|
There is a conflict you need to resolve. You should have rebased against master prior to adding the note. Then you could have added the note to the new (under development) section of the release notes which has recently been added. |
|
I resolved the conflict already. |
Agreed that the documentation is clear enough. :) The problem in our case (https://github.com/backstage/backstage) is that most of the other YAML files have |
We wanted to give our colleagues to possibility to build docs automatically when they put a
mkdocs.ymlin the docs folder of their repository. But it happened often, that they used.yamlinstead the.yml.When this PR is accepted, it will look first look for
mkdocs.ymlwhen--configis not provided. If this file is not present, it will try to findmkdocs.yaml.When both are not present, it behaves like before.
When both are present, it behaves like before.
If only the
.yamlversion it present, this one will be used as the config file.