Deploy boards > Improve annotations experience

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

• Close this issue

We have received feedback both internally and externally that point to a lack of understanding of how to use annotations in order to ensure deploy boards function correctly.

In https://docs.gitlab.com/ee/user/project/deploy_boards.html#enabling-deploy-boards, we do say the following:

Ensure Kubernetes annotations of app.gitlab.com/env: $CI_ENVIRONMENT_SLUG and app.gitlab.com/app: $CI_PROJECT_PATH_SLUG are applied to the deployments, replica sets, and pods, where $CI_ENVIRONMENT_SLUG and $CI_PROJECT_PATH_SLUG are the values of the CI variables.

We should look into if there is room to make these docs more clear or other ways of improving the UX