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
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
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
> 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
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
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
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,
>
+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
>
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
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
+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
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
12 matches
Mail list logo