We should ___ that explains how to set up the project.
To write a guide means to produce instructional documentation that walks readers through a task. It is the standard collocation: "write a getting-started guide". "Pen a doc over", "make a write off", and "draft text down" are not idiomatic. Write pairs with guide, tutorial, and documentation, and is the everyday verb for authoring docs.
2 / 5
Every public endpoint needs us to ___ thoroughly.
To document an API means to describe its endpoints, parameters, and responses so consumers can use it. It is the standard collocation: "document the API with examples". "Note the API over", "record the API off", and "log the API down" are not idiomatic. Document pairs with API, code, and process, and is essential for adoption.
3 / 5
With each release we ___ to list what changed.
To update the changelog means to add entries describing the changes in a new release. It is the standard collocation: "update the changelog before tagging". "Change the notes over", "edit logs off", and "fix the diary" are not idiomatic. Update pairs with changelog, docs, and README, keeping documentation in step with the code.
4 / 5
This tutorial is outdated, so we will ___ it.
To deprecate a page means to mark documentation as outdated and steer readers to a current version. It is the standard collocation: "deprecate the old setup page". "Cancel the page over", "retire text off", and "expire the doc down" are not idiomatic. Deprecate pairs with page, doc, and API, signalling content that should no longer be relied on.
5 / 5
A teammate will ___ to check accuracy before publishing.
To review docs means to read and verify documentation for accuracy and clarity before it ships. It is the standard collocation: "review the docs in the pull request". "Look text over off", "check pages down", and "eye notes" are not idiomatic. Review pairs with docs, code, and content, and is a quality gate for documentation.