<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, May 17, 2016 at 6:02 PM, Nigel Babu <span dir="ltr">&lt;<a href="mailto:nigelb@redhat.com" target="_blank">nigelb@redhat.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><div>We could potentially setup travis-ci to do builds that&#39;ll fail loudly if we commit something that throws a warning. I&#39;ve tried out the possibility here:<br><br><a href="https://travis-ci.org/nigelbabu/glusterdocs/jobs/130816121" target="_blank">https://travis-ci.org/nigelbabu/glusterdocs/jobs/130816121</a><br><br></div>I&#39;ve purposefully made it fail. Success looks like this:<br><br><a href="https://travis-ci.org/nigelbabu/glusterdocs/jobs/130815368" target="_blank">https://travis-ci.org/nigelbabu/glusterdocs/jobs/130815368</a><br><br></div>We can, in the future, add stuff so that documentation has working links and there are no large files checked in. If there&#39;s interest happy to send a pull request for this.<br></div></blockquote><div><br></div><div>I like this a lot. </div><div>It&#39;s a way to make sure w&#39;ere not putting in things that haven&#39;t been thoroughly checked.</div><div><br></div><div>PR welcome.</div><div><br></div><div>- amye  </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"></div><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><br><div class="gmail_quote">On Tue, May 17, 2016 at 4:55 PM, Amye Scavarda <span dir="ltr">&lt;<a href="mailto:amye@redhat.com" target="_blank">amye@redhat.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><br><div class="gmail_quote">On Tue, May 17, 2016 at 3:59 PM, Amye Scavarda <span dir="ltr">&lt;<a href="mailto:amye@redhat.com" target="_blank">amye@redhat.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote"><span><span>On Tue, May 17, 2016 at 3:56 PM, Niels de Vos <span dir="ltr">&lt;<a href="mailto:ndevos@redhat.com" target="_blank">ndevos@redhat.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span>On Tue, May 17, 2016 at 02:42:27PM +0530, Amye Scavarda wrote:<br>
&gt; Hi all,<br>
&gt;<br>
&gt; So we have a new <a href="http://slideshare.net" rel="noreferrer" target="_blank">slideshare.net</a> account, GlusterCommunity (<br>
&gt; <a href="http://www.slideshare.net/GlusterCommunity/" rel="noreferrer" target="_blank">http://www.slideshare.net/GlusterCommunity/</a>) that connects with the<br>
&gt; Gluster.org G+ community - and it&#39;ll even connect with the YouTube channel!<br>
&gt;<br>
&gt; I&#39;ve submitted a PR to the glusterdocs repo that will need some review: it<br>
&gt; removes all of the presentations from the repo and links to slideshare. (<br>
&gt; <a href="https://github.com/gluster/glusterdocs/pull/109" rel="noreferrer" target="_blank">https://github.com/gluster/glusterdocs/pull/109</a>)<br>
<br>
</span>Cool, but note that the size of the repository does not decrease with<br>
that commit. The git repository will still contain all the presentations<br>
in the history/log. But not adding any more presentations is a good step<br>
already :-)<br>
<span><br></span></blockquote></span></span><div>You are correct, but it will not make the current issue worse. It would help if I actually hit &#39;reply all&#39;. </div><span><span><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span>
&gt; In no way does this mean that anyone needs to use Slideshare to host PDFs<br>
&gt; of slides, you can use whatever you want. I chose slideshare because there<br>
&gt; was an older Gluster account that had some Gluster.com presentations and it<br>
&gt; links with YouTube.<br>
&gt;<br>
&gt; Thoughts?<br>
<br>
</span>Looks good to me, but maybe you can address this comment in the GitHub<br>
pull request:<br>
  <a href="https://github.com/gluster/glusterdocs/pull/109/files#r63498585" rel="noreferrer" target="_blank">https://github.com/gluster/glusterdocs/pull/109/files#r63498585</a><br>
<br></blockquote></span></span><div>That&#39;s why I have you all to proofread. </div><span><font color="#888888"><div><br></div></font></span></div></div></div></blockquote><div><br></div><div>One thing I&#39;m noticing, we don&#39;t have any sort of CI on Read The Docs. Let me see if there&#39;s not an easy way to fix that and have TravisCI tell us if we&#39;re about to merge something with a bunch of borked links.</div><div>-- a </div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><span><font color="#888888"><div></div><div> - amye </div></font></span><div><div><div><div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Thanks,<br>
Niels<br>
<div><div><br>
&gt; - amye<br>
&gt;<br>
&gt;<br>
&gt;<br>
&gt; On Thu, May 12, 2016 at 7:49 PM, Niels de Vos &lt;<a href="mailto:ndevos@redhat.com" target="_blank">ndevos@redhat.com</a>&gt; wrote:<br>
&gt;<br>
&gt; &gt; On Thu, May 12, 2016 at 03:55:23PM +0530, Kaushal M wrote:<br>
&gt; &gt; &gt; On Thu, May 12, 2016 at 1:25 PM, Niels de Vos &lt;<a href="mailto:ndevos@redhat.com" target="_blank">ndevos@redhat.com</a>&gt; wrote:<br>
&gt; &gt; &gt; &gt; On Thu, May 12, 2016 at 02:56:52AM -0400, Prashanth Pai wrote:<br>
&gt; &gt; &gt; &gt;&gt;<br>
&gt; &gt; &gt; &gt;&gt;<br>
&gt; &gt; &gt; &gt;&gt; &gt; &gt; Right now, even cloning the main docs branch is a huge pain due<br>
&gt; &gt; to the size<br>
&gt; &gt; &gt; &gt;&gt; &gt; &gt; of the repo.<br>
&gt; &gt; &gt; &gt;&gt; &gt; &gt; I think that branching will solve not this problem, and might<br>
&gt; &gt; make the<br>
&gt; &gt; &gt; &gt;&gt; &gt; &gt; problem worse.<br>
&gt; &gt; &gt; &gt;&gt; &gt;<br>
&gt; &gt; &gt; &gt;&gt; &gt; Branching would not increase the size of the repository itself.<br>
&gt; &gt; Only the<br>
&gt; &gt; &gt; &gt;&gt; &gt; size used on RTD will be bigger as the HTML for different branches<br>
&gt; &gt; will<br>
&gt; &gt; &gt; &gt;&gt; &gt; be generated (so contents is there 2x). Cloning the repository is<br>
&gt; &gt; not<br>
&gt; &gt; &gt; &gt;&gt; &gt; affected.<br>
&gt; &gt; &gt; &gt;&gt; &gt;<br>
&gt; &gt; &gt; &gt;&gt; &gt; Deleting files (like the presentations) will also not remove them<br>
&gt; &gt; from<br>
&gt; &gt; &gt; &gt;&gt; &gt; the git repository. It will stay possible to checkout an older<br>
&gt; &gt; version<br>
&gt; &gt; &gt; &gt;&gt; &gt; of the docs from the same repository, all of the history is<br>
&gt; &gt; downloaded<br>
&gt; &gt; &gt; &gt;&gt; &gt; once the repository is cloned.<br>
&gt; &gt; &gt; &gt;&gt; &gt;<br>
&gt; &gt; &gt; &gt;&gt; &gt; In order to reduce the size of the repository, you need to create a<br>
&gt; &gt; new<br>
&gt; &gt; &gt; &gt;&gt; &gt; one, and import the changes without the big files. While importing<br>
&gt; &gt; &gt; &gt;&gt; &gt; changes from an other (the current) repository, it is possible to<br>
&gt; &gt; modify<br>
&gt; &gt; &gt; &gt;&gt; &gt; the changes on the fly and prevent importing the big files. This<br>
&gt; &gt; keeps<br>
&gt; &gt; &gt; &gt;&gt; &gt; the history and the credits for the contributors.<br>
&gt; &gt; &gt; &gt;&gt;<br>
&gt; &gt; &gt; &gt;&gt; This is an alternative solution:<br>
&gt; &gt; &gt; &gt;&gt; <a href="https://rtyley.github.io/bfg-repo-cleaner/" rel="noreferrer" target="_blank">https://rtyley.github.io/bfg-repo-cleaner/</a><br>
&gt; &gt; &gt; &gt;<br>
&gt; &gt; &gt; &gt; Right, I was thinking about git-filter-branch. In the end, I am pretty<br>
&gt; &gt; &gt; &gt; sure that the old/original repository is not valid anymore. I expect<br>
&gt; &gt; &gt; &gt; that &#39;git rebase&#39; is used for the cleaning, and that will change the<br>
&gt; &gt; &gt; &gt; commit-ids of patches that follow after a &#39;cleaned&#39; patch.<br>
&gt; &gt; &gt; &gt;<br>
&gt; &gt; &gt; &gt; Mu recommendation for a seperate repository, is only for preventing<br>
&gt; &gt; &gt; &gt; inconsistencies between the upstream repository (after cleaning) and<br>
&gt; &gt; the<br>
&gt; &gt; &gt; &gt; previously cloned/forked repositories that contributors have.<br>
&gt; &gt; &gt; &gt;<br>
&gt; &gt; &gt; &gt;&gt; &gt; Where would you suggest the presentations (and other files?) should<br>
&gt; &gt; get<br>
&gt; &gt; &gt; &gt;&gt; &gt; located?<br>
&gt; &gt; &gt; &gt;&gt;<br>
&gt; &gt; &gt; &gt;&gt; May be an official Gluster community slideshare or speakerdeck<br>
&gt; &gt; account ?<br>
&gt; &gt; &gt; &gt;<br>
&gt; &gt; &gt; &gt; Possibly something like this. But we should have a plan for the<br>
&gt; &gt; existing<br>
&gt; &gt; &gt; &gt; presentations too. And we have to accept that not everyone presenting<br>
&gt; &gt; &gt; &gt; about a Gluster (related) topic will use &#39;our&#39; SaaS instance.<br>
&gt; &gt; &gt; &gt;<br>
&gt; &gt; &gt; &gt;&gt; Git LFS is also also an option but we don&#39;t really need versioning for<br>
&gt; &gt; &gt; &gt;&gt; presentation files. Git LFS will keep large files in a separate<br>
&gt; &gt; location<br>
&gt; &gt; &gt; &gt;&gt; and keep a &quot;pointer&quot; to those in the repo.<br>
&gt; &gt; &gt; &gt;<br>
&gt; &gt; &gt; &gt; I&#39;d prefer something like this. Most of my presentations are written<br>
&gt; &gt; &gt; &gt; while I&#39;m travelling, so a connected service is not really an option<br>
&gt; &gt; for<br>
&gt; &gt; &gt; &gt; me in any case.<br>
&gt; &gt; &gt;<br>
&gt; &gt; &gt; The docs repo should just have links to the presentations.<br>
&gt; &gt; &gt; They could be hosted on slideshare/speakerdeck, google drive or they<br>
&gt; &gt; &gt; could be hosted html5 presentations.<br>
&gt; &gt; &gt; If required we could just host the presentations on <a href="http://download.gluster.org" rel="noreferrer" target="_blank">download.gluster.org</a><br>
&gt; &gt; .<br>
&gt; &gt; &gt; I&#39;ve seen it being used to host resources for tutorials previously<br>
&gt; &gt; &gt; (like disk images),<br>
&gt; &gt; &gt; so hosting the actual presentations shouldn&#39;t be too hard.<br>
&gt; &gt;<br>
&gt; &gt; I really do not care where they are hosted. We just can not demand the<br>
&gt; &gt; use of a SaaS for them. We can offer the option of course, but still<br>
&gt; &gt; allow presenters to use the tool of their preference.<br>
&gt; &gt;<br>
&gt; &gt; Niels<br>
&gt; &gt;<br>
&gt; &gt; _______________________________________________<br>
&gt; &gt; Gluster-devel mailing list<br>
&gt; &gt; <a href="mailto:Gluster-devel@gluster.org" target="_blank">Gluster-devel@gluster.org</a><br>
&gt; &gt; <a href="http://www.gluster.org/mailman/listinfo/gluster-devel" rel="noreferrer" target="_blank">http://www.gluster.org/mailman/listinfo/gluster-devel</a><br>
&gt; &gt;<br>
&gt;<br>
&gt;<br>
&gt;<br>
&gt; --<br>
&gt; Amye Scavarda | <a href="mailto:amye@redhat.com" target="_blank">amye@redhat.com</a> | Gluster Community Lead<br>
</div></div></blockquote></div></div></div></div></div><div><div><div><div><br><br clear="all"><div><br></div>-- <br><div><div dir="ltr">Amye Scavarda | <a href="mailto:amye@redhat.com" target="_blank">amye@redhat.com</a> | Gluster Community Lead</div></div>
</div></div></div></div></div></div>
</blockquote></div><div><div><br><br clear="all"><div><br></div>-- <br><div><div dir="ltr">Amye Scavarda | <a href="mailto:amye@redhat.com" target="_blank">amye@redhat.com</a> | Gluster Community Lead</div></div>
</div></div></div></div>
<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></div><br></div>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr">Amye Scavarda | <a href="mailto:amye@redhat.com" target="_blank">amye@redhat.com</a> | Gluster Community Lead</div></div>
</div></div>