So, developer documentation. We currently use reStructuredText to write the docs, Sphinx for static html generation and Read The Docs for automatic builds from GitHub repo and docs site hosting. But we like Netlify to scale up, add a few features such as role-based access control, and generally build out a developer portal. It would help me greatly if anyone here can help me resolve the following questions before embracing Netlify:
- The Netlify Drop feature is here to stay, right? I mean it’s not going to be demoted during the next 3 to 5 years in the name of some dynamic JAMStack thing…? I really love the Netlify Drop feature where I can just drop the locally generated static html folder and see the site live in a few seconds. This feature is a must-have for us because we do not like to give access to our Python headers to any hosting site. So we will locally build static html and upload it with Drop.
- Are there any plans for Netlify to officially support Sphinx documentation builder? I looked through docs and it doesn’t mention so that means Netlify does not support it. I see someone graciously wrote up how to do it here GitHub - HangarOrg/sphinx-netlify-cicd: Automated deployments of Sphinx documentation to Netlify, but what is Netlify’s position on Sphinx? Supporting in near future? Don’t care? Use the approach described at this link and you don’t care, and if it breaks I am on my own?
- The Drop feature is a must-have, and the Sphinx docs builder feature is a “I am begging you, please” feature, decision-making-wise.
Comments, help, reassurances, showing the door? Help! Thanks! :- )