[RFE] Auto generate documentation from directory contents

[black-dragon74]

Instead of manually specifying the nav in mkdocs.yml we could autogenerate the nav links based on the directory structure.

The idea is to have a python script which does this automatically for us and then it calls the mkdocs build.

The result will be a cleaner mkdocs.yml file and to add any new section/content we will just have to create a markdown file under a directory.

Please share your thoughts.

/cc: @Shwetha-Acharya @kshithijiyer @aravindavk

[aravindavk]

-1

Keeping the required order of the chapters is difficult if it is crawl based. Directories and file names should use number prefix so that order can be maintained (Ex: 002-Install-Guide/001-Overview.md). Reorganizing or introducing a chapter is very difficult(Imagine adding a chapter between 002-* and 003-*)