Would also consider moving the Sphinx site to read the docs as well (keep the repo in github), same argument.<br><br><div class="gmail_quote">On Sat, Sep 8, 2012 at 5:45 PM, Aaron Meurer <span dir="ltr">&lt;<a href="mailto:asmeurer@gmail.com" target="_blank">asmeurer@gmail.com</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I gave my view on the matter a while back at<br>
<a href="http://mail.scipy.org/pipermail/ipython-user/2012-June/010375.html" target="_blank">http://mail.scipy.org/pipermail/ipython-user/2012-June/010375.html</a> and<br>
<a href="http://mail.scipy.org/pipermail/ipython-user/2012-June/010392.html" target="_blank">http://mail.scipy.org/pipermail/ipython-user/2012-June/010392.html</a>.  I<br>
don&#39;t really feel involved enough in the community to vote (I have<br>
never used the IPython wiki), so you should just take it as advice<br>
from my personal experience with SymPy&#39;s wikis and no more.<br>
<br>
Summary:<br>
<br>
- The GitHub wiki is pretty good, though it has its deficiencies.<br>
- The biggest strength of the GitHub wiki is that everything is just a<br>
git repository.  This pretty much makes up for the deficiencies (in my<br>
opinion).<br>
- Regardless of what you do, having more than one wiki is a serious<br>
PITA (we at one point had three).<br>
<br>
I also talked a little bit about how to transition.  It&#39;s a lot easier<br>
to deal with the GitHub wiki if you use the fact that it&#39;s a git<br>
repository, and just do all your editing locally and pushing up the<br>
results.  Unfortunately, the wiki permissions are exactly the same as<br>
the repository permissions, and there&#39;s no way to change that, so if<br>
you don&#39;t have push access and want to use git to contribute, you&#39;ll<br>
have to fork the wiki and get someone with push access to merge your<br>
changes.<br>
<br>
And by the way, I just noticed another deficiency in Gollum that I<br>
didn&#39;t notice before: it doesn&#39;t seem to have a search functionality.<br>
So if you want to search the wiki, you&#39;ll either have to use Google,<br>
or clone the wiki repo and use grep.  But it&#39;s open source, so maybe<br>
someone can contribute...<br>
<span class="HOEnZb"><font color="#888888"><br>
Aaron Meurer<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
On Sat, Sep 8, 2012 at 4:11 PM, Brian Granger &lt;<a href="mailto:ellisonbg@gmail.com">ellisonbg@gmail.com</a>&gt; wrote:<br>
&gt; Fernando has given some motivation for this proposed change, but I<br>
&gt; think a few more details are important:<br>
&gt;<br>
&gt; * Currently, we have &quot;developer docs&quot; in two locations: the IPython<br>
&gt; Sphinx docs and the mediawiki wiki site.  At best, these two locations<br>
&gt; repeat information, at worse they are inconsistent.  In practice<br>
&gt; having two locations for these things has meant that this information<br>
&gt; gets out of date.<br>
&gt; * We would like to start to develop a &quot;Development Roadmap&quot; for<br>
&gt; IPython that outlines the big picture of where we are headed.<br>
&gt; * We have started to use IPEPs (IPython Enhancement Proposals) to<br>
&gt; guide the development of particular &quot;big&quot; features.<br>
&gt;<br>
&gt; All of these things are developer related documentation that we want<br>
&gt; to make it easy for all developers to read and edit in a single<br>
&gt; location.  Because most of our development happens on github, I think<br>
&gt; it makes sense for that location to be the github wiki.  That was my<br>
&gt; original argument for hosting this context on the github wiki.<br>
&gt;<br>
&gt; &gt;From there, Fernando wisely brought up the impracticality of<br>
&gt; maintaining two wikis (github and mediawiki) and proposed to move<br>
&gt; *all* our existing mediawiki content to github as well.<br>
&gt;<br>
&gt; On Sat, Sep 8, 2012 at 2:31 PM, Fernando Perez &lt;<a href="mailto:fperez.net@gmail.com">fperez.net@gmail.com</a>&gt; wrote:<br>
&gt;&gt; Hi all,<br>
&gt;&gt;<br>
&gt;&gt; We&#39;ve been having on and off discussions about this in the middle of<br>
&gt;&gt; other threads for a while, and we think it&#39;s time to make a decision.<br>
&gt;&gt; Our current wiki setup (<a href="http://wiki.ipython.org" target="_blank">http://wiki.ipython.org</a>) is a manual mediawiki<br>
&gt;&gt; installation that we manage, with configuration mostly having been<br>
&gt;&gt; done by Thomas and myself.  We chose that instead of activating the<br>
&gt;&gt; github wiki mainly because we wanted a more &#39;user friendly&#39; space:<br>
&gt;&gt; github wikis are still located deep inside of the github site with a<br>
&gt;&gt; lot of screen space and controls that are mostly relevant to those<br>
&gt;&gt; following development more closely.<br>
&gt;&gt;<br>
&gt;&gt; But as more and more of our workflow happens on github, we are<br>
&gt;&gt; reconsidering this decision.  For example, with the new process for<br>
&gt;&gt; discussing more complex IPython enahncements via IPEPs<br>
&gt;&gt; (<a href="https://github.com/ipython/ipython/wiki/IPython-Enhancement-Proposals-%28IPEPs%29" target="_blank">https://github.com/ipython/ipython/wiki/IPython-Enhancement-Proposals-%28IPEPs%29</a>),<br>
&gt;&gt; it makes a lot of sense to work on github itself, as it lets us<br>
&gt;&gt; conveniently link all materials on one site, we reuse skills<br>
&gt;&gt; (markdown) and workflow patterns, etc.  And keeping *two* wikis, one<br>
&gt;&gt; on a manual Mediawiki install and one on github, is really more<br>
&gt;&gt; management than it&#39;s worth.  Hence the question:<br>
&gt;&gt;<br>
&gt;&gt; Should we consolidate all wiki materials on a single one on github?<br>
&gt;<br>
&gt; [ X] Yes<br>
&gt; [ ] No<br>
&gt;<br>
&gt;&gt; In terms of actually agreeing to move, we need to have a migration<br>
&gt;&gt; plan in place first, though.  Maintaining two wikis is untenable, so<br>
&gt;&gt; before we start building the new github one we need to have a solution<br>
&gt;&gt; for migrating content, which fortunately isn&#39;t too much.  Would anyone<br>
&gt;&gt; here volunteer to help out with this process?  Most likely it can be<br>
&gt;&gt; automated to a significant degree; we can give a volunteer acess to<br>
&gt;&gt; the mediawiki installation; since the github wiki is itself just a<br>
&gt;&gt; wiki repo, then running pandoc over all the pages on the existing wiki<br>
&gt;&gt; and pushing to that local repo should be pretty easy.<br>
&gt;<br>
&gt; I volunteer to move over all of our developer related docs from the<br>
&gt; various locations.<br>
&gt;<br>
&gt; Cheers,<br>
&gt;<br>
&gt; Brian<br>
&gt;<br>
&gt;&gt; Cheers,<br>
&gt;&gt;<br>
&gt;&gt; f<br>
&gt;&gt; _______________________________________________<br>
&gt;&gt; IPython-User mailing list<br>
&gt;&gt; <a href="mailto:IPython-User@scipy.org">IPython-User@scipy.org</a><br>
&gt;&gt; <a href="http://mail.scipy.org/mailman/listinfo/ipython-user" target="_blank">http://mail.scipy.org/mailman/listinfo/ipython-user</a><br>
&gt;<br>
&gt;<br>
&gt;<br>
&gt; --<br>
&gt; Brian E. Granger<br>
&gt; Cal Poly State University, San Luis Obispo<br>
&gt; <a href="mailto:bgranger@calpoly.edu">bgranger@calpoly.edu</a> and <a href="mailto:ellisonbg@gmail.com">ellisonbg@gmail.com</a><br>
&gt; _______________________________________________<br>
&gt; IPython-User mailing list<br>
&gt; <a href="mailto:IPython-User@scipy.org">IPython-User@scipy.org</a><br>
&gt; <a href="http://mail.scipy.org/mailman/listinfo/ipython-user" target="_blank">http://mail.scipy.org/mailman/listinfo/ipython-user</a><br>
_______________________________________________<br>
IPython-User mailing list<br>
<a href="mailto:IPython-User@scipy.org">IPython-User@scipy.org</a><br>
<a href="http://mail.scipy.org/mailman/listinfo/ipython-user" target="_blank">http://mail.scipy.org/mailman/listinfo/ipython-user</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Tom Brander<br><a href="http://tombrander.com" target="_blank">http://tombrander.com</a> -Real Estate<br><a href="http://oswco.com" target="_blank">http://oswco.com</a> -Open Software<br>
3763 West Jackson Blvd.<br>Birmingham, AL 35213<br>Phone 205-267-1089<br>@dartdog<br>