In the User Guide we mention, "The Basic page content type must exist. This is created on your site when you install with the core Standard installation profile" but there's no mention or explanation of "content types" in section 5 beforehand. I think adding a sentence that explains that content types are the list of items displayed in the "create content" are all "content types" would be helpful.

The only other spot I've seen content types mentioned in the user guide was in section 2.3, there's a quick example from the market site, but no explanation is given around them until section 6.1 where the user is guided through creating one.

CommentFileSizeAuthor
#3 3131269.patch326 bytesjhodgdon
#2 content-create.txt2.75 KBowenpm3
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

owenpm3 created an issue. See original summary.

owenpm3’s picture

Status: Active » Needs review
FileSize
2.75 KB
jhodgdon’s picture

FileSize
326 bytes

Thanks very much for catching this problem!!!

Here is where we explain entity types, including content types:
https://www.drupal.org/docs/user_guide/en/planning-data-types.html

If you are on section 5.2
https://www.drupal.org/docs/user_guide/en/content-create.html
it should have this topic in the Prerequisite Knowledge section. That is definitely an oversight, and the correct fix. We are trying not to duplicate information, and trying not to mix topics between tasks and concepts.

So, here's a patch.

owenpm3’s picture

Status: Needs review » Reviewed & tested by the community

Ah, got it. I haven't worked with the user guide before. Is there anything else I need to do? The patch makes sense and it does direct the reader to the right info as far as the explanation of entities/sub-types piece goes.

jhodgdon’s picture

Thanks for taking a look! And I very much appreciate that you took the time to create an issue! I'll get this committed soon.

  • jhodgdon committed fff6374 on 8.x-8.x
    Issue #3131269 by jhodgdon, owenpm3: No explanation of "content type" in...
jhodgdon’s picture

Status: Reviewed & tested by the community » Fixed

Committed -- thanks again!

jhodgdon’s picture

I'll send notification out to the translation groups as well.

  • FMB committed 579dcfc on 8.x-8.x
    [FR] Small change in content-create.txt (issue #3131269)
    

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.