Plurals in parentheses
Don't put optional plurals in parentheses. Instead, use either plural or
singular constructions and keep things consistent throughout your documentation. Choose
what is most appropriate for your documentation and your audience. If it's important in
a specific context to indicate both, use one or more.
Recommended |
Not recommended |
To find your API key, visit the Credentials page. |
To find your API key(s), visit the Credentials page. |
The value of the parent depends on the values of its children. |
The value of the parent depends on the value(s) of its child(ren). |
You can use a physical linecard, which can contain one or more ports. |
You can use a physical linecard, which can contain port(s). |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-15 UTC.
[null,null,["Last updated 2024-10-15 UTC."],[[["Avoid using parentheses to indicate optional plural forms in documentation, instead maintaining consistency with either singular or plural nouns."],["When necessary to explicitly state the possibility of singular or plural, utilize the phrase \"one or more\"."],["Choose the most suitable noun form (singular or plural) based on the context of your documentation and target audience."]]],["The core content focuses on maintaining consistency in documentation regarding singular and plural nouns. Instead of using parentheses to indicate optional plurals, documentation should consistently employ either singular or plural forms. When both are crucial, use the phrase \"one or more.\" Examples demonstrate this by replacing constructions like \"key(s)\" and \"child(ren)\" with singular \"key\" or plural \"children,\" or the \"one or more\" format when applicable.\n"]]