Re: Deprecate admindocs?

2013-07-25 Thread Daniel Greenfeld
Can we assume it will be separated out? While none of us on the list use admindocs or care, a decent number of beginners seem to like to use it. --Daniel Greenfeld On Thursday, July 25, 2013 7:21:08 PM UTC+2, Julien Phalip wrote: > > On Jul 25, 2013, at 5:29 AM, Aymeric Augustin < > aymeric@

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 appropriate > documentation, while the Python

Re: Streaming sitemaps

2013-07-25 Thread Roger Barnes
> Ah, yes, I saw mindsocket working on this at PyConAU sprints, but wasn't > sure how far through he'd got. The issues I've had with generator > responses in the past is when there's an error in rendering, they tend to > just stop. > I'm mindsocket :) The patch is ready for review insofar as I

Re: Streaming sitemaps

2013-07-25 Thread Curtis Maloney
On 26 July 2013 14:12, Roger Barnes wrote: > If you do want to go down the streaming path despite the caching, static > and other advice, I can see a couple of options: > 1) Write your own sitemap view that doesn't use the sitemap.xml template > and instead streams back results using a StreamingH

Re: Streaming sitemaps

2013-07-25 Thread Roger Barnes
If you do want to go down the streaming path despite the caching, static and other advice, I can see a couple of options: 1) Write your own sitemap view that doesn't use the sitemap.xml template and instead streams back results using a StreamingHttpResponse and generator based get_url methods in

Re: Streaming sitemaps

2013-07-25 Thread Curtis Maloney
We ended up splitting out sitemaps up... and caching them heavily. Pre-generating periodically would be equally effective. I can, however, see the merit in a generator style SiteMap engine with a StreamingHttpResponse. It would allow the client to consume the data as it's being consumed, instead

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 appropriate > documentation, while the Py

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 to deprecate admindocs. Here are my reasons: > > > > 1) It's

Re: Streaming sitemaps

2013-07-25 Thread Benjamin Wohlwend
Hi Julian, after having a site almost taken down by an over-eager spider downloading the sitemaps dozens of times in parallel, I learned the lesson that large sitemaps shouldn't be rendered on demand. Since that day a few years ago, I always generate the sitemap periodically and let apache/nginx s

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 the idea that docstrings are appropriate > documentation

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 picture in

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 deprecate admindocs. Here are my reasons: >> >> 1)

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 appropriate > documentation, while the Python an

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. 2) Even t

Re: Streaming sitemaps

2013-07-25 Thread Aymeric Augustin
Hi Julian, Thanks for the suggestion. This is an interesting idea, however, I'd like to see evidence that the performance improvement is worth the extra complexity before going forwards. > Since 1.5 we have streaming responses. What is the state of contrib.sitemaps > in this regard? I have som

Streaming sitemaps

2013-07-25 Thread julianb
Since 1.5 we have streaming responses. What is the state of contrib.sitemaps in this regard? I have some very large sitemaps and experimented with making them faster a few years ago. If the do not yet stream, I think this would be a good idea to get memory usage down. Is there anything to keep