Documentation location/URL

(various)

Problem/Motivation

On #1380720: Rename entity "bundle" to "subtype" in the UI text and help, there was a discussion about what to call entity types, bundles, and items of entities in the UI. It was decided to call them:
Entity type
Entity subtype [not sub-type or bundle]
Entity [not Entity item]

This is for when we are talking about content entities in general; we should still refer to "Content type" as the sub-type of the "Content" entity type provided by the Node module.

We need to make sure the User Guide is consistent with this.

Proposed resolution

Make sure we are using the right terminology.

Remaining tasks

Comments

jhodgdon created an issue. See original summary.

jhodgdon’s picture

Title: Make sure entity terminology is consistent » Make sure entity terminology is consistent in User Guide
Related issues: +#1380720: Rename entity "bundle" to "subtype" in the UI text and help
jhodgdon’s picture

Version: 8.x-8.x-dev » 9.1.x-dev
Status: Active » Needs review
Issue tags: +Translation updates needed
StatusFileSize
new12.42 KB

Here's a patch. Adding the translation tag because other language groups will need to probably make similar decisions?

jhodgdon’s picture

StatusFileSize
new9.88 KB
new14.53 KB

I just realized the issue summary here is incorrect. The decision on the Core issue is to use "subtype" not "sub-type". Here's a new patch.

Note: The interdiff is bigger than the patch! Suggest just reviewing the patch...

eojthebrave’s picture

The patch here looks good to me. I didn't search through all the existing files for anything that might have been missed, but we can do any other cleanup later if anything is found.

Do you think it would be worth adding something about this to the style guide? https://www.drupal.org/docs/user_guide_guidelines/guidelines-editing.html

jhodgdon’s picture

Issue summary: View changes
StatusFileSize
new10.44 KB
new575 bytes

Yes, that's an excellent idea. Also finally fixed the issue summary (subtype not sub-type).

eojthebrave’s picture

Status: Needs review » Reviewed & tested by the community

Thanks @jhodgdon. This looks good to me.

  • jhodgdon committed df890f2 on 9.1.x
    Issue #3165909 by jhodgdon, eojthebrave: Make sure entity terminology is...
jhodgdon’s picture

Status: Reviewed & tested by the community » Fixed

Committed this, except that the change to menu-reorder was omitted, as a better change to that line was committed as part of #3176742: 9.1.x compatibility for User Guide. Email going out shortly.

  • FMB committed fd6a195 on 9.1.x
    [FR] Make sure entity terminology is consistent in User Guide (#3165909)
    

Status: Fixed » Closed (fixed)

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