That is what I said, though I can see potential problems with it.
An alternative would be a third Sphinx site for Contributing, but that might overkill.
Another alternative would be that only one site has the Contributor's guide and the other site just links to it.
Personally, I'd also encourage both sites to share a standard design & layout, with perhaps a unique color scheme for each suite.
For sure. I think all the template stuff should be shared. I'm not opposed to different color schemes, though most of the coloring in docs is content specific anyway and wouldn't likely change much. (Red for warnings, blue for tips, etc.)
Not exactly related to this topic specifically, but how reasonable would it be to have "staging sites"
This is a question is ultimately for @yanokwa.
I think it would be cool to have PR-based staging deployments, so that one doesn't need to DL and build locally to do a review. I don't have a sense of the difficulty of this relative to the benefits.
Over time perhaps these could be harmonized with the OpenDataKit.org site as well
Just to be totally insane.... there's no strong reason we couldn't include opendatakit.org in a docs monorepo... even while keeping it in Jekyll.
I'm not seriously suggesting this at the moment --- but it's worth a think.