Le 15/06/2017 à 22:22, Gregory Szorc a écrit : > On Thu, Jun 15, 2017 at 1:04 PM, Andrew Halberstadt > <ahalberst...@mozilla.com <mailto:ahalberst...@mozilla.com>> wrote: > > +1 to preferring in-tree docs. > > If we're going to be adding a ton of new docs though, I think it > would be worth exploring a different sphinx theme. I find the > toctree in the side bar of the default rtd theme is already > looking cluttered and getting difficult to navigate. I imagine > with an order of magnitude more content, it will be more confusing > than helpful. > > > Yeah, there is definitely room to improve things. > > We have full control over what Sphinx plugins, themes, etc we use. You > may find tools/docs/conf.py and `./mach doc` useful for tinkering. The > Sphinx bits are an underloved feature. So any contributions would be > greatly appreciated. Feel free to flag me for review. > > As most of the people don't like to spend time writing docs, I am a bit concerned that using in-tree docs with our "heavy" review process (bug, reviewers, etc) will even decrease our contributions to the doc (instead of the MDN wiki where it is quick to contribute).
Sylvestre
_______________________________________________ dev-builds mailing list dev-builds@lists.mozilla.org https://lists.mozilla.org/listinfo/dev-builds
