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 de

Re: Deprecate admindocs?

2013-07-31 Thread Aymeric Augustin
2013/7/25 Aymeric Augustin 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 developers" group. To unsubscr

Re: Deprecate admindocs?

2013-07-31 Thread Michael Radziej
Aymeric Augustin 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 appropriate > documentation, wh

Re: Deprecate admindocs?

2013-07-25 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

Re: Deprecate admindocs?

2013-07-25 Thread Jannis Leidel
On 25.07.2013, at 14:29, Aymeric Augustin 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 a

Re: Deprecate admindocs?

2013-07-25 Thread Julien Phalip
On Jul 25, 2013, at 5:29 AM, Aymeric Augustin 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 a

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 wrote: > +1 > > -- > Loic > > On Jul 25, 2013, at 7:29 PM, Aymeric Augustin < > aymeric.augus...@polytechnique.org> wrote: > > > Hello, > > > > I'd like t

Re: Deprecate admindocs?

2013-07-25 Thread Loic Bistuer
+1 -- Loic On Jul 25, 2013, at 7:29 PM, Aymeric Augustin 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 th

Re: Deprecate admindocs?

2013-07-25 Thread Daniele Procida
On Thu, Jul 25, 2013, Aymeric Augustin 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 was working with, really helped me build a pi

Re: Deprecate admindocs?

2013-07-25 Thread Elyézer Rezende
I'd recommend putting it in a separate repo, just in case any user miss it. Considering the above, +1 On Thu, Jul 25, 2013 at 9:31 AM, Marc Tamlyn wrote: > +1 > > > On 25 July 2013 13:29, Aymeric Augustin > wrote: >> >> Hello, >> >> I'd like to

Re: Deprecate admindocs?

2013-07-25 Thread Marc Tamlyn
+1 On 25 July 2013 13:29, Aymeric Augustin 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 appropr

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 doc