# Verb forms in reference documentation

When 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*).

It's a subtle distinction that manifests mostly in whether the initial verb
in the description has an *-s* at the end or not.

Recommended: tasks.insert: Creates a new
task on the specified task list.

Not recommended: tasks.insert: Create a
new task on the specified task list.

For more information and examples, see the
[Google Cloud API design guide](https://cloud.google.com/apis/design/documentation#method_description).