doc update

Author: shawnm0705

src/features/2.metrics.md

@@ -7,11 +7,12 @@ Metric is used to allow admin configuring custom metrics for an assessment to se
 ### `analytics_metrics`
 
 * `id` id of this metric
+* `uuid` uuid of this metric
 * `name` the name of this metric
 * `description` the description of this metric
 * `is_public` whether this is a public metrics in the metrics library
 * `data_source` : which data source we are linking to for the calculation
-  * For MVP, we only support `assessment question`
+  * For MVP, we only support `question`
 * `data_type` defines how to link to an assessment question. It has the following valid value (MVP):
   * `scalar` : can only be linked to a radio button choice question of an assessment
 * `aggregation` defines how to calculate the result. It has the following valid value: (when the `data_type` is `scalar`)
@@ -36,9 +37,9 @@ Relationship between a metric and an institution
   * `recommanded` : an experience can go live without linking this metric to an assessment, but there will be a warning
   * `not required` : an experience can go live without linking this metric to an assessment
 * `status`
-  * `draft` : won't show on the experience page
-  * `active` : show on the experience page
-  * `archived` : won't show on the experience page
+  * `inactive` : when this metric is not linked to any assessment question in any experience
+  * `active` : when the metric is linked to an assessment question in an experience
+  * `archived` : the metric won't be calculated anymore
 
 ### `analytics_metric_links`
 
@@ -47,7 +48,7 @@ Relationship between a metric and a data source link in an experience
 * `id`
 * `metric_id`
 * `data_source_id` : the related data source id
-  * When `data_source` = `assessment question`, this id is the question id
+  * When `data_source` = `question`, this id is the question id
 * `experience_id`
 * `institution_id`
 * `calculation_frequency` : when to calculate the metrics
@@ -67,9 +68,9 @@ The table to store the metric report records
 
 ### Create metric
 
-There will be a page on the institution level to see all the required/recommanded metric and institution admin is able to create new metric or use a metric from the metric library.
+There will be a page on the institution level to see all the metrics in the institution and institution admin is able to create new metric or use a metric from the metric library.
 
-### Use metric
+### Configure metric
 
 On the experience dashboard, there will be a "metrics" tab. Admin can configure the metric (i.e. link metric to a specific assessment question).