<div dir="ltr">I've been toying with maintaining presentations in asciidoc format, which lends itself better to revision control and allows me to auto-publish to multiple formats relatively easily.</div><div class="gmail_extra"><br clear="all"><div><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><br>Dustin L. Black, RHCA <br>Principal Cloud Success Architect<br>Red Hat, Inc. - Strategic Customer Engagement <br>(o) +1.212.510.4138 (m) +1.215.821.7423 <br><a href="mailto:dustin@redhat.com" target="_blank">dustin@redhat.com</a> <br> <br></div></div></div></div></div></div></div></div></div>
<br><div class="gmail_quote">On Tue, May 3, 2016 at 2:05 PM, Joe Julian <span dir="ltr"><<a href="mailto:joe@julianfamily.org" target="_blank">joe@julianfamily.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class=""><br>
On 05/03/2016 05:43 AM, Nigel Babu wrote:<br>
</span><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">
Hello folks,<br>
<br>
I've just started this week at Red Hat. Over the next year or so, I'll be helping with cleaning up the existing CI pipeline and improving it so that we have much better confidence with releases.<br>
<br></span><span class="">
Amy has been helping me get an overview of the infrastructure we have and we decided to put this on readthedocs under Ops Guide[1], considering we'd like to be open about our infra. While writing this, I also noticed there were quite a few warnings from mkdocs about dead links. I've taken a few minutes to fix them up as well[2]. If anyone has a few minutes, I'd be extremely grateful if you could merge them both.<br>
<br></span><span class="">
Additionally, I notice that we have presentations on the docs git repo, which makes it burst up in size to 145 MB. This makes for a unpleasant experience cloning the repo. If we don't clone the repo, we're less likely to see the warnings from mkdocs about deadlinks and might also turn away potential contributors. If possible, I'd like to propose that the presentations be hosted elsewhere and be linked from the documentation site (without breaking existing URLs). I'm also happy to host it on a separate git repo that is exclusively used for presentations. Does anyone have any strong opinions on the matter?<br>
</span></blockquote>
<br>
I talked a long time ago about trying to have a repo for presentations. Some generic ones that could be used by a "speaker network" was something we once tried to put together.<br>
<br>
Either way, whether they stay attached to the documentation (I agree they shouldn't) or they're moved into a new repo, it should use large file storage[3] to keep the repo size reasonable.<span class=""><br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
[1]: <a href="https://github.com/gluster/glusterdocs/pull/107" rel="noreferrer" target="_blank">https://github.com/gluster/glusterdocs/pull/107</a><br>
[2]: <a href="https://github.com/gluster/glusterdocs/pull/108" rel="noreferrer" target="_blank">https://github.com/gluster/glusterdocs/pull/108</a><br>
</blockquote></span>
[3]: <a href="https://github.com/blog/1986-announcing-git-large-file-storage-lfs" rel="noreferrer" target="_blank">https://github.com/blog/1986-announcing-git-large-file-storage-lfs</a><div class="HOEnZb"><div class="h5"><br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
<br>
_______________________________________________<br>
Gluster-devel mailing list<br>
<a href="mailto:Gluster-devel@gluster.org" target="_blank">Gluster-devel@gluster.org</a><br>
<a href="http://www.gluster.org/mailman/listinfo/gluster-devel" rel="noreferrer" target="_blank">http://www.gluster.org/mailman/listinfo/gluster-devel</a><br>
</blockquote>
<br>
_______________________________________________<br>
Gluster-devel mailing list<br>
<a href="mailto:Gluster-devel@gluster.org" target="_blank">Gluster-devel@gluster.org</a><br>
<a href="http://www.gluster.org/mailman/listinfo/gluster-devel" rel="noreferrer" target="_blank">http://www.gluster.org/mailman/listinfo/gluster-devel</a><br>
</div></div></blockquote></div><br></div>