Re: Deprecate admindocs?

2013-08-08 Thread Collin Anderson
Looking at the code, we're only using docutils for parsing reST markup in docstrings. What if we made reST parsing (and docutils) optional? Seems to me admindocs would still be plenty helpful without it. > -- You received this message because you are subscribed to the Google Groups "Django

Re: Deprecate admindocs?

2013-07-31 Thread Aymeric Augustin
2013/7/25 Aymeric Augustin <aymeric.augus...@polytechnique.org> I'd like to deprecate admindocs. > Given the feedback, I'll put this plan on hold for the time being. Thank you. -- Aymeric. -- You received this message because you are subscribed to the Google Groups "Django dev

Re: Deprecate admindocs?

2013-07-31 Thread Michael Radziej
Aymeric Augustin <aymeric.augus...@polytechnique.org> writes: > Hello, > > I'd like to deprecate admindocs. Here are my reasons: > > 1) It's called the "documentation generator", but it only operates on > docstrings. This promotes the idea that docstrings are

Re: Deprecate admindocs?

2013-07-26 Thread Daniel Greenfeld
> aymeric@polytechnique.org > wrote: > > > Hello, > > > > I'd like to deprecate admindocs. Here are my reasons: > > > > 1) It's called the "documentation generator", but it only operates on > docstrings. This promotes the idea that

Re: Deprecate admindocs?

2013-07-26 Thread Jannis Leidel
On 25.07.2013, at 14:29, Aymeric Augustin <aymeric.augus...@polytechnique.org> wrote: > Hello, > > I'd like to deprecate admindocs. Here are my reasons: > > 1) It's called the "documentation generator", but it only operates on > docstrings. This

Re: Deprecate admindocs?

2013-07-25 Thread Julien Phalip
On Jul 25, 2013, at 5:29 AM, Aymeric Augustin <aymeric.augus...@polytechnique.org> wrote: > Hello, > > I'd like to deprecate admindocs. Here are my reasons: > > 1) It's called the "documentation generator", but it only operates on > docstrings. This

Re: Deprecate admindocs?

2013-07-25 Thread AJ B
If it was put in a separate repo. +1 On Thu, Jul 25, 2013 at 6:38 AM, Loic Bistuer <loic.bist...@sixmedia.com>wrote: > +1 > > -- > Loic > > On Jul 25, 2013, at 7:29 PM, Aymeric Augustin < > aymeric.augus...@polytechnique.org> wrote: > > > Hello, >

Re: Deprecate admindocs?

2013-07-25 Thread Loic Bistuer
+1 -- Loic On Jul 25, 2013, at 7:29 PM, Aymeric Augustin <aymeric.augus...@polytechnique.org> wrote: > Hello, > > I'd like to deprecate admindocs. Here are my reasons: > > 1) It's called the "documentation generator", but it only operates on >

Re: Deprecate admindocs?

2013-07-25 Thread Daniele Procida
On Thu, Jul 25, 2013, Aymeric Augustin <aymeric.augus...@polytechnique.org> wrote: >I'd like to deprecate admindocs. I love admindocs. When I first started using Django, I would always find ready to hand, and the fact that it was right there, in the interface of the thing I wa

Re: Deprecate admindocs?

2013-07-25 Thread Elyézer Rezende
gt; > wrote: >> >> Hello, >> >> I'd like to deprecate admindocs. Here are my reasons: >> >> 1) It's called the "documentation generator", but it only operates on >> docstrings. This promotes the idea that docstrings are appropriate >> documentati

Re: Deprecate admindocs?

2013-07-25 Thread Marc Tamlyn
+1 On 25 July 2013 13:29, Aymeric Augustin <aymeric.augus...@polytechnique.org>wrote: > Hello, > > I'd like to deprecate admindocs. Here are my reasons: > > 1) It's called the "documentation generator", but it only operates on > docstrings. This promotes the id

Deprecate admindocs?

2013-07-25 Thread Aymeric Augustin
Hello, I'd like to deprecate admindocs. Here are my reasons: 1) It's called the "documentation generator", but it only operates on docstrings. This promotes the idea that docstrings are appropriate documentation, while the Python and Django communities now favor prose documentation