canmove, Confirmed users
737
edits
MDN/Projects/Completed/GitHub Integration: Difference between revisions
MDN/Projects/Completed/GitHub Integration (view source)
Revision as of 23:04, 14 May 2013
, 14 May 2013no edit summary
(Created page with "==What do we want?== * To keep the documentation source for a product in GitHub, but the published docs on MDN. * To automate the publication of the docs to MDN when the sour...") |
No edit summary |
||
| Line 82: | Line 82: | ||
For the second interface, the code could be taken from the repo itself. For the first, it can't, unless the generic service is happy to clone the repo on every commit (which might be OK, depending on how large and active the repo is). | For the second interface, the code could be taken from the repo itself. For the first, it can't, unless the generic service is happy to clone the repo on every commit (which might be OK, depending on how large and active the repo is). | ||
== Readthedocs.org? == | |||
We've talked in the past about using readthedocs.org to accomplish this. I'd love to do that, but it's unclear to me where in this proposal we're using readthedocs rather than just rolling our own thing. | |||
I can understand how we could do our own thing. On the other side, I can understand how we could use readthedocs.org more or less as-is. But having looked a bit at readthedocs.org, it seems to be very heavily dependent on the docs using Sphinx/reStructuredText - so if it's important to us to support other formats (which it probably is), then it might be a big change. | |||