A how-to or tutorial document for using authentication views and forms is needed

[Daniele Procida]

There's are some substantial documents in /topics/auth/, but there isn't a step-by-step tutorial or how-to.

There's a need for it in the official documentation, because:

• it's worthwhile getting users started on the right track, so that they don't find themselves doing it insecurely or incorrectly
• there are plenty of questions on the subject on StackOverflow and elsewhere
• there are numerous (often out-of-date or incomplete) weblog articles circulating on the subject

Probably a how-to is more appropriate than a tutorial.

[Tim Graham]

#22075 contains some suggestions related to this.

[Collin Anderson]

We could better document django.contrib.auth.urls

     url('accounts/', include('django.contrib.auth.urls'),

And give an example view that uses UserCreationForm.

[Collin Anderson]

I'm interested in working on this today.

[Collin Anderson]

All I got to was an really rough outline:

- login view
- login form
- login template
- login url
- login_required
- logout view
- create view
- create form
- create template
- create url

[Haris Ibrahim K. V.]

I am working on writing up this tutorial. I have a rough draft ready here: ​https://github.com/harisibrahimkv/django/blob/3cbcca57465f0dbdf5265b0b80d0bf307ed4505e/docs/topics/auth/tutorial.txt

This is my first time and I am not sure what exactly needs to go in there.

Looking for feedback.

[Carlos Leite]

Replying to harisibrahimkv:

I am working on writing up this tutorial. I have a rough draft ready here: ​https://github.com/harisibrahimkv/django/blob/3cbcca57465f0dbdf5265b0b80d0bf307ed4505e/docs/topics/auth/tutorial.txt

This is my first time and I am not sure what exactly needs to go in there.

Looking for feedback.

this ​link to the article is broken

[Jacob Walls]

Clearing flags for any new attempt when ready.