I have worked with docusauras and I believe that initially, it requires too much developer effort to make it look beautiful or customise.<p>Got to know about Docus.dev and Nextra.site but didn't find any examples that have API docs (using OpenAPI specs)
Good documentation can't be automated. It requires someone to carefully craft working examples of all the parameters and functions that are available, so you can copy/paste them into a program to try them out.<p>I'd expect at least two separate people are required... a writer and an editor.
First problem ... define what you mean by "documentation"<p>We talking javadocs? MSDN? IBM developerWorks? Docs.Splunk? ReadTheDocs.io? GitHub readme.md? ...?