Long time lurker here.  Anyways, one thing that I think might trip up
beginners is this line:
# Quick-start development settings - unsuitable for production

For a beginner that could be a very daunting statement that could
leave them wondering:
Why is this unsuitable for production and what is suitable for
production?  Is it inefficient or insecure or both?

I think a little more explanation regarding it's unsuitability would
make it a lot less scary.  In line with what you have done here it
might make sense to add a new section to the docs describing how to
make the default settings production ready and then link to it after
that statement.

On Jan 29, 1:01 pm, Aymeric Augustin
<aymeric.augus...@polytechnique.org> wrote:
> Hello,
>
> I took into account the feedback received here and on IRC (thanks everyone!) 
> and I now have a branch ready for review:
>
> https://github.com/aaugustin/django/compare/simplify-project-template
>
> The commit messages give some hints about the reasoning behind each change. 
> I'll be glad to provide more detailed explanations if necessary.
>
> Like Jacob said, everyone here would certainly do this a bit differently. 
> Let's avoid bikeshedding — if you can't resist, tell me in private — and look 
> for problems such as:
>         - I got the priorities wrong: forgot something important / included 
> something useless,
>         - I missed some best practices,
>         - I did something that's likely to trip up beginners,
>         - etc.
>
> I plan to commit this next week. Let me know if you'd like more time to 
> review.
>
> Thank you,
>
> --
> Aymeric.

-- 
You received this message because you are subscribed to the Google Groups 
"Django developers" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-developers+unsubscr...@googlegroups.com.
To post to this group, send email to django-developers@googlegroups.com.
Visit this group at http://groups.google.com/group/django-developers?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to