I saw your versioning document, and couldn't stop thinking about the version hierachy. So I suggest:
  1. make version files more simple
  2. unify
    sidebar
    file and
    docs
    folder in one version file
Before:
├── versioned_docs
│ ├── version-1.1.0
│ │ ├── foo
│ │ │ └── bar.md # https://mysite.com/docs/foo/bar
│ │ └── hello.md
│ └── version-1.0.0
│ ├── foo
│ │ └── bar.md # https://mysite.com/docs/1.0.0/foo/bar
│ └── hello.md
├── versioned_sidebars
│ ├── version-1.1.0-sidebars.json
│ └── version-1.0.0-sidebars.json
After:
├── versions
│ ├── 1.1.0
│ │ ├── docs
│ │ ├──── foo
│ │ │ └──── bar.md # https://mysite.com/docs/foo/bar
│ │ ├──── hello.md
│ │ └── sidebars.json
│ └── 1.0.0
│ │ ├── docs
│ │ ├──── foo
│ │ │ └──── bar.md # https://mysite.com/docs/1.0.0/foo/bar
│ │ ├──── hello.md
│ │ └── sidebars.json