<div dir="ltr">Hi all,  <div class="gmail_extra"><br></div><div class="gmail_extra">Sorry for checking out on the technical discussions. It's been a busy couple of weeks! </div><div class="gmail_extra"><br></div><div class="gmail_extra">I did not particularly mind the appearance of the old site. I was more concerned with the content. </div><div class="gmail_extra"><br></div><div class="gmail_extra">In particular, quoting myself from back in May (archives of that list for that time-frame are apparently lost forever...):</div><div class="gmail_extra"><br></div><div class="gmail_extra">"<span style="font-size:12.8000001907349px">It doesn't really represent the current state of affairs, and is s source of confusion for the unwary beginner.  </span></div><div style="font-size:12.8000001907349px"><br></div><div style="font-size:12.8000001907349px">One proposal, that I would be happy to lead (if no one is really aching to do it themselves...) was to create a community portal on that page, where a large number of projects in this space could be represented through a (semi-) rational organization. Something with a front page that tells the beginner that there are many paths through this particular garden, and guides them along to what they need."</div><div class="gmail_extra"><br></div><div class="gmail_extra">The drash:</div><div class="gmail_extra"><br></div><div class="gmail_extra">- "large number of projects" precludes any particular project from appearing on the front page. I don't mind (and indeed have put) a link to the nipy github organization. See message here: <a href="https://mail.python.org/pipermail/neuroimaging/2015-July/000186.html" target="_blank">https://mail.python.org/pipermail/neuroimaging/2015-July/000186.html</a></div><div class="gmail_extra"><br></div><div class="gmail_extra">- "(semi-) rational" means that the projects are organized in a directory in a way that someone just entering the field can easily browse. </div><div class="gmail_extra"><br></div><div class="gmail_extra">- "guides them along" would mean that we would want to add content on a more-or-less regular basis with some tutorials, links to events, rants, etc.  </div><div class="gmail_extra"><br></div><div class="gmail_extra">I don't mind if we use sphinx, or pelican (or anything else), but I did choose jekyll because of its perceived advantages on the github platform (see discussion here: <a href="https://mail.python.org/pipermail/neuroimaging/2015-July/000174.html" target="_blank">https://mail.python.org/pipermail/neuroimaging/2015-July/000174.html</a>). I am always happy to be proven wrong for my choices, and for others to show me the way to the light.</div><div class="gmail_extra"><br></div><div class="gmail_extra">Cheers, </div><div class="gmail_extra"><br></div><div class="gmail_extra">Ariel </div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Aug 26, 2015 at 8:32 AM, Matthew Brett <span dir="ltr"><<a href="mailto:matthew.brett@gmail.com" target="_blank">matthew.brett@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">Hi,<br>
<span><br>
On Wed, Aug 26, 2015 at 4:10 PM, vanessa sochat <<a href="mailto:vsochat@stanford.edu" target="_blank">vsochat@stanford.edu</a>> wrote:<br>
> Hi Group,<br>
><br>
> Ben and I are having some discussion on the higher level goals of the site,<br>
> and want to bring everyone in. In summary, we want something that is easy to<br>
> contribute content to, and has continuous integration for previewing<br>
> updates. I am wondering, what was wrong with the initial look of the site?<br>
> Was it that sphinx is hard to update?<br>
<br>
</span>Actually, I think that sphinx is a very good option, and most other<br>
scientific Python sites use sphinx for their main pages.<br>
<br>
The particular template that we were using was a little dated and<br>
ugly, but I bet that could be improved.<br>
<br>
Most if not all developers are perfectly capable of building the<br>
sphinx documentation locally to preview it, but we can also do what<br>
other projects are doing, and build / publish the docs in some<br>
temporary place for each commit, using an entry in the travis-ci<br>
matrix of jobs.<br>
<br>
I think Ariel was particularly attracted to Jekyll / github pages,<br>
because it is very easy to get a rendered version to look at with a<br>
git push, and although that is generally desirable, I think building /<br>
reviewing locally is at least as important.<br>
<br>
So - if it were entirely up to me - I would prefer we go back to<br>
sphinx, on the basis that it is a very familiar workflow to most<br>
Python developers.<br>
<br>
Thanks very much for doing all this work by the way - it's very<br>
helpful, and I'm sorry that we are going round and round.<br>
<br>
See you,<br>
<br>
Matthew<br>
<div><div>_______________________________________________<br>
Neuroimaging mailing list<br>
<a href="mailto:Neuroimaging@python.org" target="_blank">Neuroimaging@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/neuroimaging" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/neuroimaging</a><br>
</div></div></blockquote></div><br></div></div>