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