reference verbs

✍️ google-blog-style

Source: https://developers.google.com/style/reference-verbs\n\n# Verb forms in reference documentation

Stay organized with collections

Save and categorize content based on your preferences.\n\n- Home\n- Products\n- Style\n\nWhen you're writing reference documentation for a method, phrase the main

method description in terms of what the method does (gets, lists, creates,

searches), rather than what the developer would use it to do (get, list,

create, search).\n\nIt's a subtle distinction that manifests mostly in whether the initial verb

in the description has an -s at the end or not.\n\nRecommended: tasks.insert: Creates a new

task on the specified task list.\n\nNot recommended: tasks.insert: Create a

new task on the specified task list.\n\nFor more information and examples, see the

Google Cloud API design guide.\n