Re: Builds docs on MDN

2017-06-15 Thread Nicholas Alexander
On Thu, Jun 15, 2017 at 1:04 PM, Andrew Halberstadt < ahalberst...@mozilla.com> wrote: > +1 to preferring in-tree docs. > +1 to this from me as well. Wish it was easier to contribute, but the in-tree docs are the best trade-off we have right now. Nick > > If we're going to be adding a ton of

Re: Builds docs on MDN

2017-06-15 Thread Gregory Szorc
On Thu, Jun 15, 2017 at 1:04 PM, Andrew Halberstadt < 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

Re: Builds docs on MDN

2017-06-15 Thread Andrew Halberstadt
+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

Builds docs on MDN

2017-06-15 Thread Gregory Szorc
MDN is pivoting hard to focus on web docs: https://blog.mozilla.org/opendesign/future-mdn-focus-web-docs/ MDN will actively start de-emphasizing docs that aren't related to the web. You can already see this on things like search results: https://developer.mozilla.org/en-US/search?q=firefox%20build