<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Apr 7, 2017 at 1:18 PM, Tanya Lattner <span dir="ltr"><<a href="mailto:tanyalattner@llvm.org" target="_blank">tanyalattner@llvm.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span class="gmail-"><br>
> On Apr 7, 2017, at 8:09 AM, Renato Golin <<a href="mailto:renato.golin@linaro.org">renato.golin@linaro.org</a>> wrote:<br></span><div class="gmail-HOEnZb"><div class="gmail-h5"><font color="#222222">...</font></div></div></blockquote><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div class="gmail-HOEnZb"><div class="gmail-h5"><span style="color:rgb(34,34,34)"> </span></div></div></blockquote><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div class="gmail-HOEnZb"><div class="gmail-h5">><br>
> In that sense, this website is somewhat similar to hosting our code on<br>
> GitHub. It's someone else's problem.<br>
><br>
</div><div class="gmail-h5"><br></div></div></blockquote></div><div class="gmail_extra"><br></div>I have been unable to find out how to change the hostname for my readthedocs project.  Changing the project name did not change the hostname, even after pushing new commits.  So <a href="https://llvm.readthedocs.org/">https://llvm.readthedocs.org/</a> still points to my fork of the LLVM github project.  So, I will delete this llvm readthedocs project unless I hear objections.  If we decide to continue to evaluate it further, we should probably hook it up to the real LLVM GH repo.  I can help execute that integration or show someone w/GH repo permissions how to do it (but it's very straightforward).</div><div class="gmail_extra"><br>Also, I dug in a little deeper on readthedocs details.  Here's more food for thought regarding this debate of "it's someone else's problem":</div><div class="gmail_extra"><br></div><div class="gmail_extra">- yes, there is an notification facility regarding failed doc builds.  Both via email and webhook, multiple entries supported for each.<br></div><div class="gmail_extra"><br></div><div class="gmail_extra">- yes, there is a way to associate additional domains with the docs.</div><div class="gmail_extra"><br></div><div class="gmail_extra">- <a href="http://readthedocs.org">readthedocs.org</a> apparently has an advertising supported model *.  In practice it seems a little rarebut they reserve that right, with some exceptions (see below).</div><div class="gmail_extra"><br></div><div class="gmail_extra">- The doc build that I magically got working just searched for the conf.py file and triggered a normal sphinx build from there.  It do not believe it ran the full LLVM_BUILD_DOCS (which would've included doxygen, right?).<br><br></div><div class="gmail_extra">- readthedocs does support building current/trunk separate from tagged releases.</div><div class="gmail_extra"><br></div><div class="gmail_extra">- other supported features: translations, page redirections (for the sake of redirecting referrers w/stale URLs, e.g.), subprojects, PDF/EPUB targets in addition to HTML, Google analytics (provide your own tracking ID).</div><div class="gmail_extra"><br></div><div class="gmail_extra"><br></div><div class="gmail_extra">* here's more details on the advertising (tl;dr please let us run occasional ads, pay us, or contribute to our open source project as a volunteer, or none of the above but don't you feel bad now?)</div><div class="gmail_extra"> </div><blockquote style="margin:0px 0px 0px 40px;border:none;padding:0px"><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">Documentation Advertising<br>Read the Docs is an open source project, maintained and operated by full-time volunteers. In order to maintain service, we rely on both the support of our users, and from sponsor support.<br>We will periodically run advertisements on built documentation pages for sponsors, however we have strict guidelines on advertisements:<ul><li style="margin:0px;padding:0px;border:0px;vertical-align:baseline">We don't give sponsors access to user information</li></ul><ul><li style="margin:0px;padding:0px;border:0px;vertical-align:baseline">We only report the number of impressions and number of ad clicks</li></ul><ul><li style="margin:0px;padding:0px;border:0px;vertical-align:baseline">We only allow and image and text, no Javascript besides our existing tracking</li></ul>For more information on our stance on sponsor advertisements, we wrote more about our stance <a href="https://blog.readthedocs.com/ads-on-read-the-docs/" style="margin:0px;padding:0px;border:0px;vertical-align:baseline;color:rgb(68,68,68)">on our blog</a>.<br>Opting out<br>If you do not wish to support Read the Docs with use of this ad space, we ask that you help support Read the Docs in one of following ways:</blockquote><div> </div></blockquote><div class="gmail_extra"><div><br></div>-- <br><div class="gmail_signature">-Brian</div>
</div></div>