Skip to content

Clarify "display" guidance - transitive vs passive voice #698

Description

@rclee33

The entry for "display" in the word usage guide (section D) states:

Use only as a transitive verb. For example, write "the system displays a message" or "the message is displayed" (not "the message displays").

The guidance mixes two different grammatical concepts:

  1. "the system displays a message" - transitive verb in active voice ✓
  2. "the message is displayed" - passive voice (not a transitive construction)
  3. "the message displays" - intransitive verb ✗

While passive voice CAN be derived from transitive verbs, saying "use only as a transitive verb" and then showing a passive voice example is inconsistent.

Suggested clarification:
Change the guidance to either:

  • "Don't use intransitively" OR
  • "Use transitively in active voice, or use passive voice"

This would make the rule clearer and align the stated guidance with the examples.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementWill improve the guide but is not a bug or blocker.

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions