Documentation consistency between display views and edit views

[Carles Pina Estany]

In the "generic display views" (​https://docs.djangoproject.com/en/3.1/ref/class-based-views/generic-display/#django.views.generic.detail.DetailView) the example is:

class ArticleDetailView(DetailView):

In the "Generic editing views" (​https://docs.djangoproject.com/en/3.1/ref/class-based-views/generic-editing/#django.views.generic.edit.CreateView.template_name_suffix) the example is:

class AuthorCreate(CreateView):

(note that there is no View after AuthorCreate, like it was in the ArticleDetailView example)

I was expecting it to be either:

class ArticleDetailView(DetailView)

class AuthorCreateView(CreateView)

or:

class ArticleDetail(DetailView)

class AuthorCreate(CreateView)

I'm happy to do a PR of any of the options. I'm slightly inclined for the second one to keep it short and because usually these classes are in views.py.

[Carlton Gibson]

Hi Carles. Yes, OK… 😄 I think this fits under the small cosmetic changes not needing a ticket. If you'd like to make a PR Fixed #32271 -- Improved naming consistency in CBV code examples. then that would be great.

[Carles Pina Estany]

Thanks Carlton, I'll do it!

[Carlton Gibson]

​PR

Hey Carles. I see you're midway through. 👍 Please uncheck Patch needs improvement when it's finished and you're ready for review. Thanks.

[Jack Aitken]

Replying to Carlton Gibson:

Hi Carlton, is this still open or does it need work? Happy to help.

​PR

Hey Carles. I see you're midway through. 👍 Please uncheck Patch needs improvement when it's finished and you're ready for review. Thanks.

[David Smith]

Hi Jack -- there was work done on the pr I've linked below, but the comments made on the PR need addressing. If you have capacity to finish this off that would be great.

​https://github.com/django/django/pull/13869

[Jack Aitken]

Replying to David Smith:

Thanks, David. I've been reviewing the history and it looks like there were some comments by Mariusz regarding the previous commit. Here's what I can gather from those comments about what should be left alone:

1. Examples in the tutorials (tutorial04.txt and tutorial05.txt) should be left alone.
2. HomePageTemplateView should be left as HomePageView.
3. AboutView should remain as AboutView

Otherwise, I can go through the changes that Carles made create a new PR, if this is all agreeable to you.

[Carles Pina Estany]

Thanks Jack for continuing the PR! Really appreciate the continuation :)

[Jack Aitken]

It's my pleasure, Carles!

PR was made. Here is the link: ​https://github.com/django/django/pull/14069

[Mariusz Felisiak <felisiak.mariusz@…>]

In 5fd4f22:

Fixed #32271 -- Improved consistency of docs CBV examples.

Co-Authored-By: Carles Pina i Estany <carles@…>

[Mariusz Felisiak <felisiak.mariusz@…>]

In 9f277c3a:

[3.2.x] Fixed #32271 -- Improved consistency of docs CBV examples.

Co-Authored-By: Carles Pina i Estany <carles@…>

Backport of 5fd4f22d196fbe9913884259ddedad10e6156a44 from master