Split up user/developer docs

[agjohnson]

We're currently running into some information architecture issues, where user related docs are being lumped in with what would be a developer related doc page. In general, having our developer docs part of our user docs is also confusing for users as this is a bit of information overload.

I purpose:

• We split up user docs to a docs/users
• User docs would be extendable, using some of the patterns i've worked out for extendable Sphinx docs
• Our commercial side would override necessary pieces to user docs so that our docs don't need preface of "If you are a commercial customer, here is how this feature works ..."
• Our developer docs would split to docs/developers
• Information on contributing and architecture go in developer docs
• We start hosting a more complex documentation set under docs.readthedocs.com, docs.readthedocs.io can still be user docs
• docs.readthedocs.com will dog food our features on subprojects, subproject search, and API usage
• docs.readthedocs.com is a landing page project that will point to all of our documentation projects, so eventually we'll even have docs.readthedocs.com/projects/theme/en/latest, etc.
• Also, our private docs will be hosted on docs.readthedocs.com?

[ericholscher]

👍 on this. I think it needs a bit more thought about how to structure it, but definitely think dogfooding all our features is an obvious win. It also would make our shortcomings around subprojects much more obvious, and likely spur us to fix them for us & our users.

[agjohnson]

I'd like to focus on this in the near term, having good docs in place would be helpful for commercial projects.

I'll start by restarting our .com POC docs, complete with landing page and such. We have a few new features that make this easier now.

[davidfischer]

We split up user docs to a docs/users
Our developer docs would split to docs/developers
Information on contributing and architecture go in developer docs

I believe that these are mostly done in #5819. All the developer docs now live under docs/development, the are no longer linked from the front page directly (one must click to "contributing" first, and all the other docs are user facing.

[humitos]

Most of this was done by @stsewd with https://dev.readthedocs.io/en/latest/, right? Should we close this issue?