From b13dcb2b9d23df21abb0d48957fc33d67bcdbaec Mon Sep 17 00:00:00 2001 From: Achilleas Pipinellis Date: Fri, 16 Jun 2017 10:56:54 +0200 Subject: Copyedit ConvDev docs --- doc/user/admin_area/monitoring/convdev.md | 29 +++++++++++++-------- .../admin_area/monitoring/img/convdev_index.png | Bin 0 -> 31012 bytes doc/user/admin_area/settings/usage_statistics.md | 3 ++- 3 files changed, 20 insertions(+), 12 deletions(-) create mode 100644 doc/user/admin_area/monitoring/img/convdev_index.png diff --git a/doc/user/admin_area/monitoring/convdev.md b/doc/user/admin_area/monitoring/convdev.md index 3cf26a52664..3d93c7557a4 100644 --- a/doc/user/admin_area/monitoring/convdev.md +++ b/doc/user/admin_area/monitoring/convdev.md @@ -1,22 +1,29 @@ # Conversational Development Index ->**Notes:** - - Conversational Development Index was [introduced][ce-30469] in GitLab 9.3. +> [Introduced][ce-30469] in GitLab 9.3. Conversational Development Index (ConvDev) gives you an overview of your entire instance's feature usage, from idea to production. It looks at your usage in the past 30 days, averaged over the number of active users in that time period. It also provides a lead score per feature, which is calculated based on GitLab's analysis -of top performing instances, based on usage ping data that GitLab has collected. -Your score is compared to the lead score, expressed as a percentage. The overall -index score is an average over all your feature scores. +of top performing instances, based on [usage ping data][ping] that GitLab has +collected. Your score is compared to the lead score, expressed as a percentage. +The overall index score is an average over all your feature scores. -The page also provides helpful links to articles and GitLab docs, to help you improve -your scores. +![ConvDev index](img/convdev_index.png) + +The page also provides helpful links to articles and GitLab docs, to help you +improve your scores. Your GitLab instance's usage ping must be activated in order to use this feature. -Usage ping data is aggregated on GitLab's servers for analysis. Your usage information -is not sent to any other GitLab instances. If you have just started using GitLab, -it may take a few weeks for data to be collected before this feature is available. +Usage ping data is aggregated on GitLab's servers for analysis. Your usage +information is **not sent** to any other GitLab instances. + +If you have just started using GitLab, it may take a few weeks for data to be +collected before this feature is available. + +This feature is accessible only to a system admin, at +**Admin area > Monitoring > ConvDev Index**. -This feature is accessible only to a system admin, at Admin Area > Monitoring > ConvDev Index. \ No newline at end of file +[ce-30469]: https://gitlab.com/gitlab-org/gitlab-ce/issues/30469 +[ping]: ../settings/usage_statistics.md#usage-ping diff --git a/doc/user/admin_area/monitoring/img/convdev_index.png b/doc/user/admin_area/monitoring/img/convdev_index.png new file mode 100644 index 00000000000..4e47ff2228d Binary files /dev/null and b/doc/user/admin_area/monitoring/img/convdev_index.png differ diff --git a/doc/user/admin_area/settings/usage_statistics.md b/doc/user/admin_area/settings/usage_statistics.md index f3745d0efa7..d874688cc29 100644 --- a/doc/user/admin_area/settings/usage_statistics.md +++ b/doc/user/admin_area/settings/usage_statistics.md @@ -3,7 +3,8 @@ GitLab Inc. will periodically collect information about your instance in order to perform various actions. -All statistics are opt-out, you can disable them from the admin panel. +All statistics are opt-out, you can enable/disable them from the admin panel +under **Admin area > Settings > Usage statistics**. ## Version check -- cgit v1.2.1