Documentation

[imre-kerr-sb1]

Are there any plans to create a separate documentation site for the OpenBao community plugins, or include them in the main OpenBao docs? Right now I have to refer to the corresponding Vault docs. Fine for now, but probably not what we want long-term.

I see that some plugins have a docs directory, with index.md and api.md files, but some (e.g. AWS auth and AWS secrets) don't.

[cipherboy]

@imre-kerr-sb1 I think they'll ultimately live under the main repo's website/ folder. We had removed some around the time of the plugin removal from the main repository, but haven't added them back. Contributions welcome in that regard. :-)

[satoqz]

@cipherboy @JanMa note that we've got another doc versioning problem to solve here since plugin versions are mostly independent of main releases.

[tmccombs]

Would it make sense to put the plugin documentation in this repo, and have it be on a separate subdomain?

[satoqz]

Maybe 🤷 It would be the simplest approach to some degree, I'd dislike maintaining another Docusaurus (or similar) root but tbf it hasn't needed much maintenance in the main repo.

[satoqz]

Also see openbao/openbao#2958 (comment). Happy to change track if we want to keep a second website.