[IPython-dev] Moving all dev docs and IPEPs to github

Carl Smith carl.input@gmail....
Sat Sep 8 16:19:20 CDT 2012


I'd like to see a user focussed nb based set of docs for new users, but not
a whole seperate wiki. There's currently nothing that I know of that serves
as a self-contained user manual. Perhaps start with A Brief Tour, then one
nb per topic, but as a complete guide for users. I'd be keen to do a bunch
of work on this, but would need some help with it.
On Sep 8, 2012 9:26 PM, "Fernando Perez" <fperez.net@gmail.com> wrote:

> On Fri, Sep 7, 2012 at 11:20 AM, Brian Granger <ellisonbg@gmail.com>
> wrote:
>
> > In my mind, a user focused wiki and a dev focused wiki could be
> > maintained separately.  I really want to keep all of our dev related
> > things on github as it makes our dev process much more discoverable.
> > But I do agree that having two wikis is a bit silly.
>
> I think a wiki can have a 'dev' area and a 'user' area, but having two
> systems is more overhead than makes sense for us.  We have such a
> small and constrained team, we really need to minimize all overhead.
>
> > I think that moving everything to github is the best way to have all
> > our dev related docs in one place rather than 3 or 4.  I am definitely
> > +1 on the idea.
>
> Well, let's go ahead and have a quick vote from everyone who has a
> stake in it (aka anyone who has contributed to the wiki or is likely
> to)...  I'll just send a separate email on it.  Let's have the vote on
> the user list so users who aren't subscribed here also have a chance
> to voice their opinion.
>
> > Yes, our roadmap needs to be informal, flexible, non-verbose and
> > dynamic.  I would like something that people feel good about updating
> > often with small bits of information that is useful to all.  I don't
> > want something that takes hours to update or is otherwise a burden to
> > us.  I think that having most of our dev process managed by issues and
> > PRs works great and I don't want to mess with that.  It is just a
> > little bit of the bigger picture stuff that we need a bit more
> > organization on.  And honestly, the IPEPs will help with that as well.
>
> Agreed.
>
> Cheers,
>
> f
> _______________________________________________
> IPython-dev mailing list
> IPython-dev@scipy.org
> http://mail.scipy.org/mailman/listinfo/ipython-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.scipy.org/pipermail/ipython-dev/attachments/20120908/e6c43d3f/attachment-0001.html 


More information about the IPython-dev mailing list