Docs with sphinx for HC3

[SebastianGode]

Summary of the Pull Request

Adds required files and entries to be able to produce doc output for our HC3.

[SebastianGode]

It could break your public documentation a bit as the toctree inside the index.md will likely be rendered there as well and that will look ugly.
Don't know if there's a good other solution.
https://github.com/opentelekomcloud/terraform-provider-opentelekomcloud/blob/docs-sphinx/docs/index.md

[anton-sidelnikov]

Hello @SebastianGode, is it possible to keep current structure like in https://registry.terraform.io/providers/opentelekomcloud/opentelekomcloud/latest/docs ?

Current docs reads subcategory field and put docs in same place if category match, and the divide them on resources and data-sources:

[anton-sidelnikov]

maybe toctree will not renders if you put it in between ---
--- {toctree} ---

[SebastianGode]

maybe toctree will not renders if you put it in between --- --- {toctree} ---

This sadly doesn't work.
We could add it on build time, but I'm not sure on how to do this without making git aware of it.

[otc-zuul]

Build succeeded.
https://zuul.otc-service.com/t/eco/buildset/4d46de45740d433fb82cc3fb24161b2f

✔️ build-otc-releasenotes SUCCESS in 5m 12s
✔️ otc-golangci-lint SUCCESS in 2m 53s
✔️ golang-make-test SUCCESS in 5m 30s
✔️ golang-make-vet SUCCESS in 5m 09s
✔️ tflint SUCCESS in 3m 00s
✔️ goreleaser-build SUCCESS in 6m 54s