Update dictionary definitions for source code

config/metrics/counts_28d/20210216182034_deploy_keys.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.deploy_keys
-description:
+description: Count of project and public deploy keys created for GitLab projects
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_28d/20210216182036_keys.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.keys
-description:
+description: Count of total unique SSH keys
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_28d/20210216182038_remote_mirrors.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.remote_mirrors
-description:
+description: Count of total remote mirrors. Includes both push and pull mirrors
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_28d/20210216182040_action_monthly_active_users_project_repo.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.action_monthly_active_users_project_repo
-description:
+description: Count of monthly active users who have performed any git operation (read/write/push)
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_28d/20210216182041_action_monthly_active_users_git_write.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.action_monthly_active_users_git_write
-description: Aggregated value for wiki, design and project repo actions
+description: Aggregated value for wiki, design, and project repo git write actions
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_28d/20210216182043_projects_enforcing_code_owner_approval.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.projects_enforcing_code_owner_approval
-description:
+description: Count of total projects that require approval by code owners for code changes
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_28d/20210216182045_projects_with_sectional_code_owner_rules.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.projects_with_sectional_code_owner_rules
-description:
+description: Count of projects using code owners with code owners section feature
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_28d/20210216182049_projects_with_repositories_enabled.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.projects_with_repositories_enabled
-description:
+description: Count of projects that have a matching git repository, result of a git push action
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_28d/20210216182051_protected_branches.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.protected_branches
-description:
+description: Count of repositories making use of at least one protected branch
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_28d/20210216182102_wiki_action_monthly.yml

 ---
 key_path: redis_hll_counters.source_code.wiki_action_monthly
-description:
+description: Count of unique actions done on a wiki (create, edit, delete)
 product_section: dev
 product_stage: create
 product_group: group::source code
-product_category:
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: 28d

config/metrics/counts_28d/20210216182106_design_action_monthly.yml

 ---
 key_path: redis_hll_counters.source_code.design_action_monthly
-description:
+description: Count of total design actions (upload, delete, comment, reply)
 product_section: dev
 product_stage: create
 product_group: group::source code
-product_category:
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: 28d

config/metrics/counts_28d/20210216182109_project_action_monthly.yml

 ---
 key_path: redis_hll_counters.source_code.project_action_monthly
-description:
+description: Count of unique actions done on projects and related resources (create, edit, delete, comment) 
 product_section: dev
 product_stage: create
 product_group: group::source code
-product_category:
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: 28d

config/metrics/counts_28d/20210216183613_total_number_of_path_locks.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.total_number_of_path_locks
-description: ''
-product_section: ''
-product_stage: ''
-product_group: ''
-product_category: ''
+description: Number of paths/directories manually locked through the UI
+product_section: dev
+product_stage: create
+product_group: group::source code
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: 28d

config/metrics/counts_28d/20210216183614_total_number_of_locked_files.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.total_number_of_locked_files
-description: ''
-product_section: ''
-product_stage: ''
-product_group: ''
-product_category: ''
+escription: The total number of files which have been locked via the GitLab UI 
+product_section: dev
+product_stage: create
+product_group: group::source code
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: 28d

config/metrics/counts_28d/20210216184047_git_write_action_monthly.yml

 ---
 key_path: redis_hll_counters.source_code.git_write_action_monthly
-description: ''
-product_section: ''
-product_stage: ''
-product_group: ''
-product_category: ''
+description: Count of unique git write actions
+product_section: dev
+product_stage: create
+product_group: group::source code
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: 28d

config/metrics/counts_all/20210216181959_projects_with_repositories_enabled.yml

 ---
 key_path: counts.projects_with_repositories_enabled
-description:
+description: Count of projects that have a matching git repository, result of a git push action
 product_section: dev
 product_stage: create
 product_group: group::source code
-product_category:
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: all

config/metrics/counts_all/20210216182001_protected_branches.yml

 ---
 key_path: counts.protected_branches
-description:
+description: Count of total protected branches
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182002_remote_mirrors.yml

 ---
 key_path: counts.remote_mirrors
-description:
+description: Count of total remote mirrors. Includes both push and pull mirrors
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182004_commit_comment.yml

 ---
 key_path: counts.commit_comment
-description:
+description: Count of total unique commit comments. Does not include MR diff comments
 product_section: dev
 product_stage: create
 product_group: group::source code
-product_category: code_review
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: all

config/metrics/counts_all/20210216182006_source_code_pushes.yml

 ---
 key_path: counts.source_code_pushes
-description:
+description: Count of total Git push operations
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182008_template_repositories.yml

 ---
 key_path: counts.template_repositories
-description:
+description: Count of total repo templates used to aggregate all file templates
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182010_deploy_keys.yml

 ---
 key_path: usage_activity_by_stage.create.deploy_keys
-description:
+description: Count of total project and public deploy keys
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182012_keys.yml

 ---
 key_path: usage_activity_by_stage.create.keys
-description:
+description: Count of total unique SSH keys
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182014_projects_with_disable_overriding_approvers_per_merge_request.yml

 ---
 key_path: usage_activity_by_stage.create.projects_with_disable_overriding_approvers_per_merge_request
-description:
+description: Total count of projects that do not allow overriding approvers on discrete merge requests
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182015_projects_without_disable_overriding_approvers_per_merge_request.yml

 ---
 key_path: usage_activity_by_stage.create.projects_without_disable_overriding_approvers_per_merge_request
-description:
+description: Count of total projects that do not disable overriding approvers per discrete merge request
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182017_remote_mirrors.yml

 ---
 key_path: usage_activity_by_stage.create.remote_mirrors
-description:
+description: Count of total remote mirrors. Includes both push and pull mirrors
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182019_projects_enforcing_code_owner_approval.yml

 ---
 key_path: usage_activity_by_stage.create.projects_enforcing_code_owner_approval
-description:
+description: Count of total projects that require approval by code owners for code changes
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182021_projects_with_sectional_code_owner_rules.yml

 ---
 key_path: usage_activity_by_stage.create.projects_with_sectional_code_owner_rules
-description:
+description: Count of projects using code owners with code owners section feature
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182023_projects_with_repositories_enabled.yml

 ---
 key_path: usage_activity_by_stage.create.projects_with_repositories_enabled
-description:
+description: Count of projects that have a matching git repository, result of a git push action
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182025_protected_branches.yml

 ---
 key_path: usage_activity_by_stage.create.protected_branches
-description:
+description: Count of repositories making use of at least one protected branch
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182027_total_number_of_path_locks.yml

 ---
 key_path: usage_activity_by_stage.create.total_number_of_path_locks
-description: The total number of default branch locks done through the GitLab UI
+description: Number of paths/directories manually locked through the UI
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182028_total_number_of_locked_files.yml

 ---
 key_path: usage_activity_by_stage.create.total_number_of_locked_files
-description: The total number of exclusive file locks (through the CLI)
+description: The total number of files which have been locked via the GitLab UI 
 product_section: dev
 product_stage: create
 product_group: group::source code

config/metrics/counts_all/20210216182454_protected_branches_except_default.yml

 ---
 key_path: counts.protected_branches_except_default
-description: ''
-product_section: ''
-product_stage: ''
-product_group: ''
-product_category: ''
+description: Count of branches that have been protected and are not the default branch
+product_section: dev
+product_stage: create
+product_group: group::source code
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: all

config/metrics/counts_all/20210216183344_users_using_path_locks.yml

 ---
 key_path: usage_activity_by_stage.create.users_using_path_locks
-description: ''
-product_section: ''
-product_stage: ''
-product_group: ''
-product_category: ''
+description: Number of users who have manually locked paths/directories through the UI 
+product_section: dev
+product_stage: create
+product_group: group::source code
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: all

config/metrics/counts_all/20210216183346_users_using_lfs_locks.yml

 ---
 key_path: usage_activity_by_stage.create.users_using_lfs_locks
-description: ''
-product_section: ''
-product_stage: ''
-product_group: ''
-product_category: ''
+description: Number of unique users who have locked files or directories using LFS via the command line
+product_section: dev
+product_stage: create
+product_group: group::source code
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: all

doc/development/usage_ping/dictionary.md

@@ -5100,7 +5100,7 @@ Tiers: `free`, `premium`, `ultimate`
 
 Missing description
 
-[YAML definition](https://gitlab.com/gitlab-org/gitlab/-/blob/master/config/metrics/counts_all/20210216182001_protected_branches.yml)
+[YAML definition](https://gitlab.com/gitlab-org/gitlab/-/blob/master/config/metrics/counts_all/)
 
 Group: `group::source code`
 

ee/config/metrics/counts_28d/20210216182047_merge_requests_with_overridden_project_rules.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.merge_requests_with_overridden_project_rules
-description: Number of merge requests that have local rules that have overwritten
-  a project rule
+description: Number of merge requests which have overriden rules created at the project level
 product_section: dev
 product_stage: create
 product_group: group::source code

ee/config/metrics/counts_28d/20210216182053_users_using_path_locks.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.users_using_path_locks
-description: Number of users that have used exclusive file locks through the CLI
+description: Number of paths/directories manually locked through the UI
 product_section: dev
 product_stage: create
 product_group: group::source code

ee/config/metrics/counts_28d/20210216182054_users_using_lfs_locks.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.users_using_lfs_locks
-description: Number of users that have used default branch locks through the UI
+description: Number of unique users who have locked files or directories using LFS via the command line
 product_section: dev
 product_stage: create
 product_group: group::source code

ee/config/metrics/counts_28d/20210216182056_approval_project_rules.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.approval_project_rules
-description: Number of project approval rules
+description: Total number of project approval rules
 product_section: dev
 product_stage: create
 product_group: group::source code

ee/config/metrics/counts_28d/20210216182058_approval_project_rules_with_target_branch.yml

 ---
 key_path: usage_activity_by_stage_monthly.create.approval_project_rules_with_target_branch
-description: Number of project approval rules with not default target branch
+description: Number of project approval rules scoped to a specific repo branch.
 product_section: dev
 product_stage: create
 product_group: group::source code

ee/config/metrics/counts_7d/20210216182100_wiki_action_weekly.yml

 ---
 key_path: redis_hll_counters.source_code.wiki_action_weekly
-description:
+description: Count of unique actions done on a wiki (create, edit, delete)
 product_section: dev
 product_stage: create
 product_group: group::source code
-product_category:
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: 7d

ee/config/metrics/counts_7d/20210216182104_design_action_weekly.yml

 ---
 key_path: redis_hll_counters.source_code.design_action_weekly
-description:
+description: Count of total design actions (upload, delete, comment, reply)
 product_section: dev
 product_stage: create
 product_group: group::source code
-product_category:
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: 7d

ee/config/metrics/counts_7d/20210216182107_project_action_weekly.yml

 ---
 key_path: redis_hll_counters.source_code.project_action_weekly
-description:
+description: Count of unique actions done on projects and related resources (create, edit, delete, comment)
 product_section: dev
 product_stage: create
 product_group: group::source code
-product_category:
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: 7d

ee/config/metrics/counts_7d/20210216184045_git_write_action_weekly.yml

 ---
 key_path: redis_hll_counters.source_code.git_write_action_weekly
-description: ''
-product_section: ''
-product_stage: ''
-product_group: ''
-product_category: ''
+description: Count of unique git write actions
+product_section: dev
+product_stage: create
+product_group: group::source code
+product_category: source_code_management
 value_type: number
 status: data_available
 time_frame: 7d

ee/config/metrics/counts_all/20210216182030_approval_project_rules.yml

 ---
 key_path: usage_activity_by_stage.create.approval_project_rules
-description: Number of project approval rules
+description: Total number of project approval rules
 product_section: dev
 product_stage: create
 product_group: group::source code

ee/config/metrics/counts_all/20210216182032_approval_project_rules_with_target_branch.yml

 ---
 key_path: usage_activity_by_stage.create.approval_project_rules_with_target_branch
-description: Number of project approval rules with not default target branch
+description: Number of project approval rules scoped to a specific repo branch.
 product_section: dev
 product_stage: create
 product_group: group::source code