wg-metrics-development
wg-metrics-development copied to clipboard
Organizational Diversity- Released metric review
Organization Diversity
Organization Diversity released metric can be reviewed in the following google doc: https://docs.google.com/document/d/1ovKej_43HxSi6v4TJnGtQ9nDKI7ONGoEQHViE_ohl2k/edit
If substantial changes are made to the metric, it will need to go through the full review process. The working group will determine if a metric has been edited to an extent that requires the full review
Types of metric changes that do not require full review:
- Grammar or spelling fixes (not including metric name)
- Updates to sections References and Contributors
- Three new additions are listed below
We will also add the following to each metric:
- Data statement (focused on privacy concerns. Now part of the metrics template at the top of the implementation section)
- Add a last reviewed date to each metric reviewed. Make a note that this date is part of a recurring review. Indicate if we did grammar/clarity edits, or put the metric through a full review. This will vary by metric.
- Add known synonyms to the metric
These are the checklist items to address in each metrics review. These are the checklist items to address in each metrics review: Put these in each issue for all of the metrics above and put that issue number / link above next to the checklist item.
Content Quality
- [ ] Required headings are filled in, including Questions.
- [ ] Description provides context to metric
- [ ] Objectives list sample uses for the metric and desired outcomes
- [ ] If any, DEI uses of the metric are included Objectives
- [ ] Review for inclusive naming
- [ ] Optional headings that have no content were removed
- [ ] Contributors section lists those contributors that want to be named
- [ ] The name of the metric is the same in (1) metric heading, (2) metric file name, (3) focus area, (4) metrics spreadsheet, (5) “review issue”, (6) translation issue, and (7) website
Technical Requirements
- [ ] Message in the metric markdown file that the metric will be part of the next regular release is at top of page and the links are correct (this is in the metric template) (If necessary)
- [ ] Metric file name is the full metric name and only contains lower case letters and hyphens (“-”) for spaces
- [ ] Images are included using markdown and absolute links (as described in the metrics template) (absolute links are required for the website. Relative links break all the time.)
- [ ] Images have at least one empty line above and below them
- [ ] Ensure images are placed in image folder and followed naming convention
- [ ] If a new focus area is created, ensure focus area is added to wg repo readme and focus area folder readme
- [ ] Within the focus area, add the metric in the table and provide the link to the metric and metric question
- [ ] Ensure tables within metric are converted as images and placed in the image folder (both original MD and screenshotted PNG format) and follow the naming convention
- [ ] No HTML code in the metrics markdown file
I took the action item to create an issue and doc to review this metric, and I didn't realize that we already had an issue with a Google doc created.
Since this is an old issue from January, maybe we can re-start this with my new Google doc? https://docs.google.com/document/d/1pmHkaPrQG0eh1OZtiMqZ33ewuYBlmhW1wTrzBIqdcaY/edit
The PR for this update #178
This metric has been released, so we can close this issue.