From 237915f4cb165528ab95cc1989ef380905d87d1d Mon Sep 17 00:00:00 2001
From: Alex Loosley <alex.loosley@zalando.de>
Date: Thu, 31 Aug 2023 13:03:38 +0200
Subject: [PATCH 1/3] Zalando data and model card templates

---
 templates/Data Card - Zalando Template.md  | 2504 ++++++++++++++++++++
 templates/Model Card - Zalando Template.md |  207 ++
 2 files changed, 2711 insertions(+)
 create mode 100644 templates/Data Card - Zalando Template.md
 create mode 100644 templates/Model Card - Zalando Template.md

diff --git a/templates/Data Card - Zalando Template.md b/templates/Data Card - Zalando Template.md
new file mode 100644
index 0000000..b361a46
--- /dev/null
+++ b/templates/Data Card - Zalando Template.md	
@@ -0,0 +1,2504 @@
+<!-- info: This data card template was
+derived for usage at Zalando based on existing
+[Huggingface](https://huggingface.co/docs/hub/datasets-cards) and
+[Google](https://sites.research.google/datacardsplaybook/) templates.
+-->
+
+<h1>Dataset Name (Acronym)</h1>
+
+Data card contributions and feedback are welcome!
+
+## Template Version
+<!-- scope: telescope -->
+<!-- info: link to data card version -->
+[0.2.1]()
+
+## Overview
+
+#### Last Update
+DD/MM/YYYY
+(See [version section](#dataset-version-and-maintenance) for details)
+
+#### Author(s)
+<!-- info: Authors should get credit in overview section
+
+Select one or more roles per author and reference author's
+emails to ease communication and add transparency.
+
+If there are more than five authors, add them all in the authorship section and
+create a reference to that section.
+-->
+
+- **Name, Team:** (Owner / Contributor / Manager / etc.)
+- **Name, Team:** (Owner / Contributor / Manager / etc.)
+- ...
+
+See the [Authorship section](#authorship) for full list of authors (if more than 5)
+
+#### Data Summary
+<!-- width: full -->
+
+Write a short summary describing your dataset (limit
+200 words). Include information about the content
+and topic of the data, sources and motivations for the
+dataset, benefits and the problems or use cases it is
+suitable for. For readers that only take 10 seconds to look
+at this data card, adding one good overview image might also
+make the difference between this data being discovered
+and going unnoticed.
+
+#### Status
+<!-- scope: telescope -->
+<!-- info: Select **one:** -->
+**Status Date:** DD/MM/YYYY
+
+**Under Preparation** - The dataset is still under active curation
+and is not yet ready for use due to active "dev" updates.
+
+**Regularly Updated** - New versions of the dataset
+have been or will continue to be
+made available.
+
+**Actively Maintained** - No new versions will be made
+available, but this dataset will
+be actively maintained,
+including but not limited to
+updates to the data.
+
+**Limited Maintenance** - The data will not be updated,
+but any technical issues will be
+addressed.
+
+**Deprecated** - This dataset is obsolete or is
+no longer being maintained.
+
+#### Relevant Links
+<!-- info: Provide a list of relevant links for quick accessibility
+by documentation consumers.
+
+The examples below represent
+: -->
+<!-- width: full -->
+* [Dataset Link] - i.e. link to S3 bucket, SQL or Big Query tables, etc.
+* [Initiative Link] - i.e. link to initiative through which the curation of this dataset was carried out
+* [Code Repository Links] - i.e. link to GitHub, GitLab or other type of code repository
+* [Data Quality Monitoring Link(s)] - i.e. link to Data Quality Framework dashboard
+* [Labeling Job Link(s)] - i.e. link to SageMaker Ground Truth job
+* [Governance Processes Lin(s)] - i.e. link to review process for obtaining permission to access dataset for use on a specific use case
+
+## Authorship
+### Author(s)
+<!-- scope: microscope -->
+<!-- info: **If** they were not all covered in the overview
+(i.e. when there are more than 5 authors), provide the details
+of all authors here:
+-->
+
+- **Name, Team:** (Owner / Contributor / Manager / etc.)
+- **Name, Team:** (Owner / Contributor / Manager / etc.)
+
+### Dataset Owners
+#### Contact Detail(s)
+<!-- scope: periscope -->
+<!-- info: Provide more information about dataset ownership: -->
+- **Main point of contact:** Provide the name and email address of the main point of contact
+- **Team:** Provide the team name and email address for the dataset owner team
+- **Affiliation:** Provide the affiliation including team and company or university of the dataset owners (e.g. Size and Fit, Zalando SE)
+- **Team Website:** Provide a link to the website for the dataset owner team
+
+### Funding Sources
+<-- info: Use these sections if relevant.
+
+For example, this may be relevant if it is funded by an
+NGO and has specific requirements and restriction for use
+of the data. Providing information as such allows us to
+avoid inappropriate downstream use of the data. -->
+
+#### Institution(s)
+<!-- scope: telescope -->
+<!-- info: Provide the names of the funding institution(s): -->
+- Name of Institution
+- Name of Institution
+- Name of Institution
+
+#### Funding or Grant Summary(ies)
+<!-- scope: periscope -->
+<!-- width: full -->
+<!-- info: Provide a short summary of programs or projects that may have funded
+the creation, collection, or curation of the dataset.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+*For example, Institution 1 and institution 2 jointly funded this dataset as a
+part of the XYZ data program, funded by XYZ grant awarded by institution 3 for
+the years YYYY-YYYY.*
+
+Summarize here. Link to documents if available.
+
+**Additional Notes:** Add here
+
+### Publishers
+<!-- info: Skip/Remove section if dataset not intended for third party usage: -->
+
+#### Publishing Organization(s)
+<!-- scope: telescope -->
+<!-- info: Provide the names of the institution or organization responsible
+for publishing the dataset: -->
+Organization Name
+
+#### Industry Type(s)
+<!-- scope: periscope -->
+<!-- info: Select **all applicable** industry types to which the publishing
+organizations belong: -->
+- Corporate - Tech
+- Corporate - Non-Tech (please specify)
+- Academic - Tech
+- Academic - Non-Tech (please specify)
+- Not-for-profit - Tech
+- Not-for-profit - Non-Tech (please specify)
+- Individual (please specify)
+- Others (please specify)
+
+#### Contact Detail(s)
+<!-- scope: microscope -->
+<!-- info: Provide publisher contact details: -->
+- **Publishing POC:** Provide the name for a POC for this dataset's publishers
+- **Affiliation:** Provide the POC's institutional affiliation
+- **Contact:** Provide the POC's contact details
+- **Mailing List:** Provide a mailing list if available
+- **Website:** Provide a website for the dataset if available
+
+## Dataset Overview
+#### Primary Data Modality
+<!-- scope: telescope -->
+<!-- info: Select the modality(ies) that best describe a typical data point
+(see http://www.trustworthymachinelearning.com/trustworthymachinelearning-04.htm,
+section 4.1, for a definition of data modality): -->
+- Image Data
+- Text Data
+- Tabular Data
+- Audio Data
+- Video Data
+- Time Series
+- Graph Data
+- Geospatial Data
+- Multimodal (please specify)
+- Unknown
+- Others (please specify)
+
+#### Data Subject(s)
+<!-- scope: telescope -->
+<!-- info: Select ***all applicable**** subjects contained the dataset: -->
+- Sensitive Data about people
+- Non-Sensitive Data about people
+- Data about natural phenomena
+- Data about places and objects
+- Synthetically generated data
+- Data about systems or products and their behaviors
+- Unknown
+- Others (Please specify)
+
+#### Dataset Description
+<!-- scope: periscope -->
+<!-- info: A description of the dataset going beyond what was described in
+the data summary in the overview section at the top of the data card.
+
+Use this section only if it adds value.
+-->
+
+#### Data Point Description
+<!-- scope: microscope -->
+<!-- info: Provide a short description of the content in a data point: -->
+
+Add description here.
+
+See the [Examples of Data Points](#example-of-data-points) section for examples.
+
+### Dataset Statistics
+<!-- scope: periscope -->
+<!-- info: Provide statistics of the dataset:<br><br>(Add or remove fields
+based on which fields you think are most important for data card
+consumers to read about at a glance.
+Use the additional notes to include relevant information, considerations,
+and links to table(s) with more detailed breakdowns.) -->
+| Category                                | Data      |
+|-----------------------------------------|-----------|
+| Size of Dataset                         | 123456 MB |
+| Number of Data Points                   | 123456    |
+| Number of Data Points with Missing Data | 12324152  |
+| Number of Labels                        | 123456789 |
+| Algorithmic Labels                      | 123456789 |
+| Protected Attribute Labels              | 123456789 |
+| Other Characteristics                   | 123456    |
+
+**Above:** Provide a caption for the above table of visualization.
+
+**Additional Notes:** Add here.
+
+### Tables and Fields
+<!-- width: full -->
+<!-- scope: microscope -->
+<!-- info: List the dataset fields and their descriptions.
+**Do not create a second source of truth.**  If information about tables already
+exists (for example, in Collibra), provide a link to it.
+
+If there are many tables to describe,
+a data card might not be the best place to describe them all.  If there is
+no other table schematization tool being used, consider adding only the
+most relevant info here if it's likely not to change.
+
+For `Type` use [python typing standards](https://docs.python.org/3/library/typing.html).
+
+Note, figures are worth 1000 tables. When possible, default
+to using figures such as histograms over statistical tables.
+-->
+
+#### TABLE: name_of_table_1
+<!-- width: full -->
+- **Primary Key:** ...
+- **Description:** ...
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| Field Name | Type | Description |
+| Field Name | Type | Description |
+| Field Name | Type | Description |
+
+**Above:** Provide a caption for the above table or visualization if used.
+
+**Additional Notes:** Add here including reference to the
+[sensitive and protected attributes](#sensitive-and-protected-attributes) section,
+when relevant.
+
+| Statistic | Field Name | Field Name | Field Name | Field Name | Field Name | Field Name |
+|-----------|------------|------------|------------|------------|------------|------------|
+| count     |            |            |            |            |            |            |
+| mean      |            |            |            |            |            |            |
+| std       |            |            |            |            |            |            |
+| min       |            |            |            |            |            |            |
+| 25%       |            |            |            |            |            |            |
+| 50%       |            |            |            |            |            |            |
+| 75%       |            |            |            |            |            |            |
+| max       |            |            |            |            |            |            |
+| mode      |            |            |            |            |            |            |
+
+**Additional Notes:** Add here.
+
+---
+
+#### TABLE: name_of_table_2
+<!-- width: full -->
+- **Primary Key:** ...
+- **Description:** ...
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| Field Name | Type | Description |
+| Field Name | Type | Description |
+| Field Name | Type | Description |
+
+**Above:** Provide a caption for the above table or visualization if used.
+
+**Additional Notes:** Add here including reference to the
+[sensitive and protected attributes](#sensitive-and-protected-attributes) section,
+when relevant.
+
+| Statistic | Field Name | Field Name | Field Name | Field Name | Field Name | Field Name |
+|-----------|------------|------------|------------|------------|------------|------------|
+| count     |            |            |            |            |            |            |
+| mean      |            |            |            |            |            |            |
+| std       |            |            |            |            |            |            |
+| min       |            |            |            |            |            |            |
+| 25%       |            |            |            |            |            |            |
+| 50%       |            |            |            |            |            |            |
+| 75%       |            |            |            |            |            |            |
+| max       |            |            |            |            |            |            |
+| mode      |            |            |            |            |            |            |
+
+**Additional Notes:** Add here.
+
+
+### Dataset Version and Maintenance
+
+#### Version Details
+<!-- scope: periscope -->
+<!-- info: Provide details about the current data version
+and which data version the current data card corresponds to.
+
+For datasets without version number, use "Not currently tracked"
+but be sure to track the release date of the data.
+
+```
+**Current Data Version:** Not currently tracked
+
+**Data Version Release Date:** 05/03/2023
+
+**Data Version for last Data Card Update:** N/A
+
+**Last Data Card Update:** 10/03/2023
+```
+-->
+**Current Data Version:** 1.0
+
+**Data Version Release Date:** DD/MM/YYYY
+
+**Data Version for last Data Card Update:** 1.0
+
+**Last Data Card Update:** DD/MM/YYYY (same as in data overview at top)
+
+#### Data Change Log
+<!-- scope: periscope -->
+Link to change log (if exists)
+
+#### Maintenance Plan
+<!-- scope: microscope -->
+<!-- info: Summarize the maintenance plan for the dataset:
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+Summarize here. Include links and metrics where applicable.
+
+**Versioning:** Summarize here. Include information about criteria for
+versioning the dataset.
+
+**Updates:** Summarize here. Include information about criteria for refreshing
+or updating the dataset.
+
+**Errors:** Summarize here. Include information about criteria for refreshing
+or updating the dataset.
+
+**Feedback:** Summarize here. Include information about criteria for refreshing
+or updating the dataset.
+
+**Additional Notes:** Add here
+
+#### Next Planned Update(s)
+<!-- scope: periscope -->
+<!-- info: Provide details about the next planned update:
+For datasets that are not currently version controlled or
+under active development that are not yet stable,
+this section could be filled in as follows:
+
+```
+**Version affected:** Not currently tracked
+
+**Next data update:** Ongoing until version 1.0.0 released
+
+**Next version:** 1.0.0
+
+**Next version update:** 04/2029 (expected first stable dataset release,
+                                  ie. version 1.0.0)
+
+```
+
+-->
+**Version affected:** 1.0
+
+**Next data update:** MM/YYYY
+
+**Next version:** 1.1
+
+**Next version update:** MM/YYYY
+
+#### Expected Change(s)
+<!-- scope: microscope -->
+<!-- info: Summarize the updates to the dataset and/or data that are expected
+on the next update.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+**Updates to Data:** Summarize here. Include links, charts, and visualizations
+as appropriate.
+
+**Updates to Dataset:** Summarize here. Include links, charts, and
+visualizations as appropriate.
+
+**Additional Notes:** Add here
+
+## Example of Data Points
+<!-- info: Show representative examples of different
+types of data points.-->
+
+#### Sampling of Data Points
+<!-- scope: periscope -->
+<!-- info: Provide link(s) to data points OR
+a link to an exploratory demo if one exists -->
+- Typical Data Point Link
+- Outlier Data Point Link
+- Other Data Point Link
+- Other Data Point Link
+
+#### Typical Data Point
+<!-- width: half -->
+<!-- info: Provide an example of a typical data point and describe what makes
+it typical.
+
+**Use additional notes to capture any other relevant information or
+considerations.** -->
+Summarize here. Include any criteria for typicality of data point.
+
+```
+{'q_id': '8houtx',
+  'title': 'Why does water heated to room temperature feel colder than the air around it?',
+  'selftext': '',
+  'document': '',
+  'subreddit': 'explainlikeimfive',
+  'answers': {'a_id': ['dylcnfk', 'dylcj49'],
+  'text': ["Water transfers heat more efficiently than air. When something feels cold it's because heat is being transferred from your skin to whatever you're touching. ... Get out of the water and have a breeze blow on you while you're wet, all of the water starts evaporating, pulling even more heat from you."],
+  'score': [5, 2]},
+  'title_urls': {'url': []},
+  'selftext_urls': {'url': []},
+  'answers_urls': {'url': []}}
+```
+
+**Additional Notes:** Add here
+
+#### Atypical Data Point
+<!-- width: half -->
+<!-- info: Provide an example of an outlier data point and describe what makes
+it atypical.
+
+**Use additional notes to capture any other relevant information or
+considerations.** -->
+Summarize here. Include any criteria for atypicality of data point.
+
+```
+{'q_id': '8houtx',
+  'title': 'Why does water heated to room temperature feel colder than the air around it?',
+  'selftext': '',
+  'document': '',
+  'subreddit': 'explainlikeimfive',
+  'answers': {'a_id': ['dylcnfk', 'dylcj49'],
+  'text': ["Water transfers heat more efficiently than air. When something feels cold it's because heat is being transferred from your skin to whatever you're touching. ... Get out of the water and have a breeze blow on you while you're wet, all of the water starts evaporating, pulling even more heat from you."],
+  'score': [5, 2]},
+  'title_urls': {'url': []},
+  'selftext_urls': {'url': []},
+  'answers_urls': {'url': []}}
+```
+
+**Additional Notes:** Add here
+
+## Purpose and Motivations
+<!-- info: This section focuses on the initial reasons why the
+dataset was curated / created, and should be written from the point
+of view of the dataset developers before and during its creation.
+
+For current usage guidelines, see the section.
+-->
+
+### Intended Purpose(s)
+<!-- scope: telescope -->
+<!-- info: Select the original intended purposes of creating or
+curating this dataset-->
+- Monitoring
+- Research
+- Evaluation
+- Production
+- Others (please specify)
+
+### Motivating Factor(s)
+<!-- scope: microscope -->
+<!-- info: List the primary motivations for creating or curating this dataset:
+
+(Usage Note: use this to describe the problem space and corresponding
+motivations for the dataset.) -->
+For example:
+
+- Bringing demographic diversity to imagery training data for object-detection models
+- Encouraging academics to take on second-order challenges of cultural representation in object detection
+
+Summarize motivation here. Include links where relevant.
+
+### Intended Use
+#### Dataset Use(s)
+<!-- scope: telescope -->
+<!-- info: Select **one**: -->
+- Safe for production use
+- Safe for research use
+- Conditional use - some unsafe applications
+- Only approved use
+- Others (please specify)
+
+#### Suitable Use Case(s)
+<!-- scope: periscope -->
+<!-- info: Summarize known suitable and intended use cases of this dataset.
+
+Use additional notes to capture any specific patterns that readers should
+look out for, or other relevant information or considerations. -->
+**Suitable Use Case:** Summarize here. Include links where necessary.
+
+**Suitable Use Case:** Summarize here. Include links where necessary.
+
+**Suitable Use Case:** Summarize here. Include links where necessary.
+
+**Additional Notes:** Add here
+
+#### Unsuitable Use Case(s)
+<!-- scope: microscope -->
+<!-- info: Summarize known unsuitable and unintended use cases of this dataset.
+
+Use additional notes to capture any specific patterns that readers should look
+out for, or other relevant information or considerations. -->
+**Unsuitable Use Case:** Summarize here. Include links where necessary.
+
+**Unsuitable Use Case:** Summarize here. Include links where necessary.
+
+**Unsuitable Use Case:** Summarize here. Include links where necessary.
+
+**Additional Notes:** Add here
+
+#### Research and Problem Space(s)
+<!-- scope: periscope -->
+<!-- info: Provide a description of the specific problem space that this
+dataset intends to address. -->
+Summarize here. Include any specific research questions.
+
+
+## Information for Usage
+<!-- info: Information about dataset for others that
+want to use this dataset. -->
+
+### Usage Guideline(s)
+<!-- scope: microscope -->
+<!-- info: Summarize usage guidelines or policies that consumers should be
+aware of.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+**Usage Guidelines:** Summarize here. Include links where necessary.
+
+**Approval Steps:** Summarize here. Include links where necessary.
+
+**Reviewer:** Provide the name of a reviewer for publications referencing
+this dataset.
+
+**Additional Notes:** Add here
+
+### Use with Other Data
+#### Safety Level
+<!-- scope: telescope -->
+<!-- info: Select **one**: -->
+- Safe to use with other data
+- Conditionally safe to use with other data
+- Should not be used with other data
+- Unknown
+- Others (please specify)
+
+#### Best Practices
+<!-- scope: microscope -->
+<!-- info: Summarize best practices for using this dataset with other datasets
+or data types.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+Summarize here. Include visualizations, metrics, demonstrative examples,
+or links where necessary.
+
+**Additional Notes:** Add here
+
+### Forking and Sampling
+#### Safety Level
+<!-- scope: telescope -->
+<!-- info: Select **one**: -->
+- Safe to fork and/or sample
+- Conditionally safe to fork and/or sample
+- Should not be forked and/or sampled
+- Unknown
+- Others (please specify)
+
+#### Acceptable Sampling Method(s)
+<!-- scope: periscope -->
+<!-- info: Select **all applicable** acceptable methods to sample this
+dataset: -->
+- Cluster Sampling
+- Haphazard Sampling
+- Multi-stage sampling
+- Random Sampling
+- Retrospective Sampling
+- Stratified Sampling
+- Systematic Sampling
+- Weighted Sampling
+- Unknown
+- Unsampled
+- Others (please specify)
+
+#### Best Practice(s)
+<!-- scope: microscope -->
+<!-- info: Summarize the best practices for forking or sampling this dataset.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+Summarize here. Include links, figures, and demonstrative examples where
+available.
+
+**Additional Notes:** Add here
+
+#### Risk(s) and Mitigation(s)
+<!-- scope: periscope -->
+<!-- info: Fill this out if you selected "Conditionally safe to fork and/or
+sample" or "Should not be forked and/or sampled":
+
+Summarize known or residual risks associated with forking and sampling methods
+when applied to the dataset.
+
+Use additional notes to capture any other
+relevant information or considerations. -->
+Summarize here. Include links and metrics where applicable.
+
+**Risk Type:** [Description + Mitigations]
+
+**Risk Type:** [Description + Mitigations]
+
+**Risk Type:** [Description + Mitigations]
+
+**Additional Notes:** Add here
+
+#### Limitation(s) and Recommendation(s)
+<!-- scope: microscope -->
+<!-- info: Fill this out if you selected "Conditionally safe to fork and/or
+sample" or "Should not be forked and/or sample":
+
+Summarize the limitations that the dataset introduces when forking
+or sampling the dataset and corresponding recommendations.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+Summarize here. Include links and metrics where applicable.
+
+**Limitation Type:** [Description + Recommendation]
+
+**Limitation Type:** [Description + Recommendation]
+
+**Limitation Type:** [Description + Recommendation]
+
+**Additional Notes:** Add here
+
+### Notable Feature(s)
+<!-- scope: periscope -->
+<!-- info: Describe any notable feature distributions or relationships between
+individual data points made explicit.
+
+Include links to servers where readers can explore the data on their own. -->
+
+**Exploration Demo:** [Link to server or demo.]
+
+**Notable Field Name:** Describe here. Include links, data examples, metrics,
+visualizations where relevant.
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+### Distribution(s)
+<!-- scope: periscope -->
+<!-- info: Describe the recommended splits and corresponding criteria.
+
+Use additional notes to capture any other
+relevant information or considerations. -->
+
+| Set        | Recommended number of data points |
+|------------|-----------------------------------|
+| Train      | 62,563                            |
+| Test       | 62,563                            |
+| Validation | 62,563                            |
+| Dev        | 62,563                            |
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+### Known Correlation(s)
+<!-- scope: microscope -->
+<!-- info: Summarize any known correlations with
+the indicated features in this dataset.
+
+Use additional notes to capture any other
+relevant information or considerations.
+
+(Usage Note: Duplicate for each known
+correlation.) -->
+`field_name`, `field_name`
+
+**Description:** Summarize here. Include
+visualizations, metrics, or links where
+necessary.
+
+**Impact on dataset use:** Summarize here.
+Include visualizations, metrics, or links
+where necessary.
+
+**Risks from correlation:** Summarize here.
+Include recommended mitigative steps if
+available.
+
+**Additional Notes:** Add here
+
+### Split Statistics
+<!-- scope: periscope -->
+<!-- width: full -->
+<!-- info: Provide the sizes of each split. As appropriate, provide any
+descriptive statistics for features. -->
+
+| Statistic             | Train  | Test   | Valid  | Dev    |
+|-----------------------|--------|--------|--------|--------|
+| Count                 | 123456 | 123456 | 123456 | 123456 |
+| Descriptive Statistic | 123456 | 123456 | 123456 | 123456 |
+| Descriptive Statistic | 123456 | 123456 | 123456 | 123456 |
+| Descriptive Statistic | 123456 | 123456 | 123456 | 123456 |
+
+**Above:** Caption for table above.
+
+### Citation Guidelines
+<!-- scope: microscope -->
+<!-- info: Provide guidelines and steps for citing this dataset in research
+and/or production.
+
+For research cases, provide a BiBTeX record (see template below).
+
+For non research cases, we suggest others reference the dataset by
+providing a link to this data card (or comparable data documentation).
+
+Use additional notes to capture any specific patterns that readers should look
+out for, or other relevant information or considerations. -->
+
+**Guidelines:** Summarize citation guidelines with link to data documentation (i.e this data card).
+
+**BiBTeX:**
+```
+@article{kuznetsova2020open,
+  title={The open images dataset v4},
+  author={Kuznetsova, Alina and Rom, Hassan and Alldrin, and others},
+  journal={International Journal of Computer Vision},
+  volume={128},
+  number={7},
+  pages={1956--1981},
+  year={2020},
+  publisher={Springer}
+}
+```
+
+**Additional Notes:** Add here
+
+
+## Known Usages
+<!-- info: Fill out the following section if the dataset has any
+current known usages.
+-->
+#### Models(s)
+<!-- scope: telescope -->
+<!-- info: Provide a table of known models
+that use this dataset.
+-->
+
+| **Model**           | **Model Task**       | **Purpose of Dataset Usage** |
+|---------------------|----------------------|------------------------------|
+| [Example Model 1]() | Image Segmentation   | Fairness evaluation          |
+| [Example Model 2]() | Skin Tone Classifier | Training and validation      |
+
+Note, this table does not have to be exhaustive. Dataset users and documentation consumers at large
+are highly encouraged to contribute known usages.
+
+#### Application(s)
+<!-- scope: telescope -->
+<!-- info: Provide a table of known AI/ML systems
+that use this dataset.
+-->
+
+| **Application**           | **Brief Description**        | **Purpose of Dataset Usage**                           | **[AI Act Risk](https://digital-strategy.ec.europa.eu/en/policies/regulatory-framework-ai)** |
+|---------------------------|------------------------------|--------------------------------------------------------|----------------------------------------------------------------------------------------------|
+| [Example Application 1]() | Size and Fit Recommendations | Fairness Evaluation of end to end application pipeline | Limited                                                                                      |
+
+Note, this table does not have to be exhaustive. Dataset users and documentation consumers at large
+are highly encouraged to contribute known usages.
+
+
+## Access, Retention, and Deletion
+<!-- info: NEEDS INPUT FROM PRIV-GOV! -->
+### Access
+#### Relevant Links
+* [Link to filestore]
+* [Link to governance processes for data access]
+* ...
+
+#### Data Security Classification
+<!-- scope: telescope -->
+<!-- info: Select **one**: Use your companies data access classification
+standards (replace the classifications below accordingly) -->
+- C1
+- C2
+- C3
+- C4
+- Others (please specify)
+
+#### Prerequisite(s)
+<!-- scope: microscope -->
+<!-- info: Please describe any required training or prerequisites to access
+this dataset. -->
+For example:
+
+This dataset requires membership in [specific] database groups:
+
+- Complete the [Mandatory Training]
+- Read [Data Usage Policy]
+- Initiate a [Data Processing Request]
+- Get AWS IAM role with S3 bucket access
+- Add Databricks cluster or other technical users to correct roles
+
+### Retention
+#### Duration
+<!-- scope: periscope -->
+<!-- info: Specify the duration for which this dataset can be retained: -->
+Specify duration in days, months, or years.
+
+#### Reasons for Duration
+<!-- scope: periscope -->
+<!-- info: Specify the reason for duration for which this dataset can be retained: -->
+**Reason**
+
+#### Policy Summary
+<!-- scope: microscope -->
+<!-- info: Summarize the retention policy for this dataset. -->
+**Policy:** Add a link to the policy if it's standardized at your company (i.e. S3 bucket standard retention policies).
+
+**Summary:** Write summary here if link does not provide all information already.
+
+**Additional Notes:** Add here
+
+#### Exception(s) and Exemption(s)
+<!-- scope: microscope -->
+<!-- info: Summarize any exceptions and related steps to retain the dataset.
+Include links where necessary.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+**Exemption Code:** `ANONYMOUS_DATA` /
+`EMPLOYEE_DATA` / `PUBLIC_DATA` /
+`INTERNAL_BUSINESS_DATA` /
+`SIMULATED_TEST_DATA`
+
+**Summary:** Write summary and notes here.
+
+**Additional Notes:** Add here
+
+### Deletion
+#### Deletion Event Summary
+<!-- scope: microscope -->
+<!-- info: Summarize the sequence of events and allowable processing for data
+deletion.
+
+If there are too many events to list, or if this information
+is stored and managed elsewhere, do not
+create a second source of truth and simply provide a link instead.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+**Sequence of deletion and processing events:**
+
+- Summarize first event here
+- Summarize second event here
+- Summarize third event here
+
+**Additional Notes:** Add here
+
+#### Acceptable Means of Deletion
+<!-- scope: periscope -->
+<!-- info: List the acceptable means of deletion: -->
+- Write acceptable means of deletion
+- Write acceptable means of deletion
+- Write acceptable means of deletion
+
+#### Post-Deletion Obligations
+<!-- scope: microscope -->
+<!-- info: Summarize the sequence of obligations after a deletion event.
+
+**Use additional notes to capture any other relevant information or
+considerations.** -->
+**Sequence of post-deletion obligations:**
+
+- Summarize first obligation here
+- Summarize second obligation here
+- Summarize third obligation here
+
+**Additional Notes:** Add here
+
+#### Operational Requirement(s)
+<!-- scope: periscope -->
+<!-- info: List any deletion integration operational requirements: -->
+**Deletion Integration Operational Requirements:**
+
+- Write first requirement here
+- Write second requirement here
+- Write third requirement here
+
+#### Exceptions and Exemptions
+<!-- scope: microscope -->
+<!-- info: Summarize any exceptions and related steps to a deletion event.
+
+**Use additional notes to capture any other relevant information or
+considerations.** -->
+**Policy Exception bug:** [bug]
+
+**Summary:** Write summary and notes here
+
+**Additional Notes:** Add here
+
+## Provenance
+### Collection
+#### Method(s) Used
+<!-- scope: telescope -->
+<!-- info: Select **all applicable** methods used to collect data.
+
+Note on crowdsourcing, this covers the case where a crowd labels data
+(make sure the reference the [Annotations and Labeling](#annotations-and-labeling)
+section), or the case where a crowd is responsible for collecting and
+submitting data independently to form a collective dataset.
+-->
+- API
+- Artificially generated
+- Crowdsourced - Internal Employee
+- Crowdsourced - External Paid
+- Crowdsourced - Volunteer
+- Vendor collection efforts
+- Scraped or crawled
+- Survey, forms, or polls
+- Interviews, focus groups
+- Scientific experiment
+- Taken from other existing datasets
+- Unknown
+- To be determined
+- Others (please specify)
+
+#### Methodology Detail(s)
+<!-- scope: periscope -->
+<!-- info: Provide a description of each collection method used.
+
+Use additional notes to capture any other relevant information or
+considerations.
+
+(Usage Note: Duplicate and complete the following for collection method
+type.) -->
+**Collection Type**
+
+**Source:** Describe here. Include links where available.
+
+**Platform:** [Platform Name], Describe platform here. Include links where relevant.
+
+**Is this source considered sensitive or high-risk?** [Yes/No]
+
+**Dates of Collection:** [MMM YYYY - MMM YYYY]
+
+**Update Frequency for collected data:**
+
+*Usage Note: Select one for this collection type.*
+
+- Yearly
+- Quarterly
+- Monthly
+- Biweekly
+- Weekly
+- Daily
+- Hourly
+- Static
+- Others (please specify)
+
+**Additional Links for this collection:**
+
+See section on [Access, Rention, and Deletion](#access-retention-and-deletion)
+
+**Additional Notes:** Add here
+
+#### Source Description(s)
+<!-- scope: microscope -->
+<!-- info: Provide a description of each upstream source of data.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+- **Source:** Describe here. Include links, data examples, metrics, visualizations where relevant.
+- **Source:** Describe here. Include links, data examples, metrics, visualizations where relevant.
+- **Source:** Describe here. Include links, data examples, metrics, visualizations where relevant.
+
+**Additional Notes:** Add here
+
+#### Collection Cadence
+<!-- scope: telescope -->
+<!-- info: Select **all applicable**: -->
+**Static:** Data was collected once from single or multiple sources.
+
+**Streamed:** Data is continuously acquired from single or multiple sources.
+
+**Dynamic:** Data is updated regularly from single or multiple sources.
+
+**Others:** Please specify
+
+### Attribute Collection Criteria and Integration
+#### Data Integration
+<!-- scope: periscope -->
+<!-- info: List all fields collected from different sources, and specify if
+they were included or excluded from the dataset.
+
+Use additional notes to
+capture any other relevant information or considerations.
+
+(Usage Note: Duplicate and complete the following for each upstream
+source.)
+
+If included and excluded fields don't apply, just write a short
+summary about how data was integrated into this dataset from
+upstream sources.
+
+-->
+**Source**
+
+**Included Fields**
+
+Data fields that were collected and are included in the dataset.
+
+| Field Name | Description                                                                          |
+|------------|--------------------------------------------------------------------------------------|
+| Field Name | Describe here. Include links, data examples, metrics, visualizations where relevant. |
+| Field Name | Describe here. Include links, data examples, metrics, visualizations where relevant. |
+
+**Additional Notes:** Add here
+
+**Excluded Fields**
+
+Data fields that were collected but are excluded from the dataset.
+
+| Field Name | Description                                                                          |
+|------------|--------------------------------------------------------------------------------------|
+| Field Name | Describe here. Include links, data examples, metrics, visualizations where relevant. |
+| Field Name | Describe here. Include links, data examples, metrics, visualizations where relevant. |
+
+**Additional Notes:** Add here
+
+#### Data Aggregation
+<!-- scope: microscope -->
+<!-- info: Summarize how data from different sources or methods aggregated,
+processed, or connected.
+
+This section is not intended to discuss transformations, which are described
+in the transformations section.
+
+(Usage Note: Duplicate and complete the following for each source OR
+collection method.) -->
+**[Aggregation step 1]:** [[GitHub Repository Link]()]
+
+Describe step 1.
+
+**[Aggregation step 2]:** [[GitHub Repository Link]()]
+
+Describe step 2.
+
+...
+
+
+### Data Point Collection Criteria
+#### Data Selection
+<!-- scope: telescope -->
+<!-- info: Summarize the data selection criteria.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+- **Collection Method of Source:** Summarize data selection criteria here. Include links where available.
+- **Collection Method of Source:** Summarize data selection criteria here. Include links where available.
+- **Collection Method of Source:** Summarize data selection criteria here. Include links where available.
+
+**Additional Notes:** Add here
+
+#### Data Inclusion
+<!-- scope: periscope -->
+<!-- info: Summarize the data inclusion criteria.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+- **Collection Method of Source:** Summarize data inclusion criteria here. Include links where available.
+- **Collection Method of Source:** Summarize data inclusion criteria here. Include links where available.
+- **Collection Method of Source:** Summarize data inclusion criteria here. Include links where available.
+
+**Additional Notes:** Add here
+
+#### Data Exclusion
+<!-- scope: microscope -->
+<!-- info: Summarize the data exclusion criteria.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+- **Collection Method of Source:** Summarize data exclusion criteria here. Include links where available.
+- **Collection Method of Source:** Summarize data exclusion criteria here. Include links where available.
+- **Collection Method of Source:** Summarize data exclusion criteria here. Include links where available.
+
+**Additional Notes:** Add here
+
+### Relationship to Source
+#### Use and Utility(ies)
+<!-- scope: telescope -->
+<!-- info: Describe how the resulting dataset is aligned with the purposes,
+motivations, or intended use of the upstream source(s).
+
+Use additional notes to capture any other relevant information or
+considerations.
+
+(Usage Note: Duplicate and complete the following for each source type.) -->
+- **Source Type:** Summarize here. Include links where available.
+- **Source Type:** Summarize here. Include links where available.
+- **Source Type:** Summarize here. Include links where available.
+
+**Additional Notes:** Add here
+
+#### Benefit and Value(s)
+<!-- scope: periscope -->
+<!-- info: Summarize the benefits of the resulting dataset to its consumers,
+compared to the upstream source(s).
+
+Use additional notes to capture any other relevant information or
+considerations.
+
+(Usage Note: Duplicate and complete the following for each source type.)
+
+Compared to the Use and Utilities section above, which describe the use, this
+section generally describes what benefits come from these usages and the
+value system in which those benefits provide value.
+
+-->
+- **Source Type:** Summarize here. Include links where available.
+- **Source Type:** Summarize here. Include links where available.
+- **Source Type:** Summarize here. Include links where available.
+
+**Additional Notes:** Add here
+
+#### Limitation(s) and Trade-Off(s)
+<!-- scope: microscope -->
+<!-- info: What are the limitations of the resulting dataset to its consumers,
+compared to the upstream source(s)?
+
+Break down by source type.<br><br>(Usage Note: Duplicate and complete the
+following for each source type.) -->
+- **Source Type:** Summarize here. Include links where available.
+- **Source Type:** Summarize here. Include links where available.
+- **Source Type:** Summarize here. Include links where available.
+
+## Sensitive and Protected Attributes
+### Sensitivity of Data
+<!-- info: Be mindful not to repeat any information that might be in a technical
+risk assessment or data processing request somewhere else.  Use references where necessary,
+or write TDB where no answers are currently known?
+
+This section is under development with ProdSec, PrivGov, and
+Algorithmic Privacy and Fairness (for ethical assessment). -->
+
+#### Sensitivity Type(s)
+<!-- scope: telescope -->
+<!-- info: Select ***all applicable*** data types present in the dataset: -->
+- User Content
+- User Metadata
+- User Activity Data
+- Identifiable Data
+- S/PII
+- Business Data
+- Employee Data
+- Pseudonymous Data
+- Anonymous Data
+- Health Data
+- Children’s Data
+- None
+- Others (Please specify)
+
+#### Field(s) with Sensitive Data
+<!-- scope: periscope -->
+<!-- info: List fields in the dataset that contain S/PII, and specify if their
+collection was intentional or unintentional.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+**Intentional Collected Sensitive Data**
+
+(S/PII were collected as a part of the
+dataset creation process.)
+
+| Field Name | Description   |
+|------------|---------------|
+| Field Name | Type of S/PII |
+| Field Name | Type of S/PII |
+| Field Name | Type of S/PII |
+
+**Unintentionally Collected Sensitive Data**
+
+(S/PII were not explicitly collected as a
+part of the dataset creation process but
+can be inferred using additional
+methods.)
+
+| Field Name | Description   |
+|------------|---------------|
+| Field Name | Type of S/PII |
+| Field Name | Type of S/PII |
+| Field Name | Type of S/PII |
+
+**Additional Notes:** Add here
+
+#### Security and Privacy Handling
+<!-- scope: microscope -->
+<!-- info: Summarize the measures or steps to handle sensitive data in this
+dataset and list relevant data governance processes
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+
+Summarize here. Include relevant links to relevant data governance and security processes
+
+**Governance Process 1:** description
+
+**Governance Process 1:** description
+
+**Privacy Requirements:** description
+
+**Privacy Preserving Processes:** (i.e. anonymization, masking, etc.) description
+
+**Additional Notes:** Add here
+
+#### Risk Type(s)
+<!-- scope: telescope -->
+<!-- info: Select **all applicable** risk types presenting from the
+dataset: -->
+- Direct Risk
+- Indirect Risk
+- Residual Risk
+- No Known Risks
+- Others (Please Specify)
+
+### Protected Attributes
+#### Protected Attribute Type(s)
+<!-- scope: telescope -->
+<!-- info: Select **all attributes** that are represented (directly or
+indirectly) in the dataset. -->
+- Gender
+- Socio-economic status
+- Geography
+- Language
+- Age
+- Culture
+- Experience or Seniority
+- Others (please specify)
+
+#### Field(s) with Protected Attributes
+<!-- scope: periscope -->
+<!-- info: List fields in the dataset that contain protected attributes, and
+specify if their collection was intentional or unintentional.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+**Intentionally Collected Attributes**
+
+Protected attributes were labeled or collected as a part of the dataset creation
+process.
+
+| Field Name | Description                    |
+|------------|--------------------------------|
+| Field Name | Protected Attributed Collected |
+| Field Name | Protected Attributed Collected |
+
+**Additional Notes:** Add here
+
+**Unintentionally Collected Attributes**
+
+Protected attributes were not explicitly collected as a part of the dataset
+creation process but can be inferred using additional methods.
+
+| Field Name | Description                    |
+|------------|--------------------------------|
+| Field Name | Protected Attributed Collected |
+| Field Name | Protected Attributed Collected |
+
+**Additional Notes:** Add here
+
+#### Rationale
+<!-- scope: microscope -->
+<!-- info: Describe the motivation, rationale, considerations or approaches
+that caused this dataset to include the indicated protected attributes.
+
+Summarize why or how this might affect the use of the dataset. -->
+Summarize here. Include links, table, and media as relevant.
+
+#### Source(s)
+<!-- scope: periscope -->
+<!-- info: List the sources of the protected attributes.
+
+Use additional notes to capture any other relevant information or
+considerations. -->
+- **Protected Attribute:** Sources
+- **Protected Attribute:** Sources
+- **Protected Attribute:** Sources
+
+**Additional Notes:** Add here
+
+#### Methodology Detail(s)
+<!-- scope: microscope -->
+<!-- info: Describe the methods used to collect sensitive/protected
+attributes in the dataset.
+
+Use additional notes to capture any other relevant information or
+considerations.
+
+(Usage Note: Duplicate and complete the following for each protected
+attribute.) -->
+
+**Protected Attribute Collection Method:** Describe the collection method here. Include links where necessary
+
+**Collection task:** Describe the task here. Include links where necessary
+
+**Platforms, tools, or libraries:**
+
+- [Platform, tools, or libraries]: Write description here
+- [Platform, tools, or libraries]: Write description here
+- [Platform, tools, or libraries]: Write description here
+
+**Additional Notes:** Add here
+
+#### Known Correlations to Protected Attributes
+<!-- scope: periscope -->
+<!-- info: Describe any known correlations with the indicated sensitive
+attributes in this dataset.
+
+Use additional notes to capture any other relevant information or
+considerations.
+
+(Usage Note: Duplicate for each known correlation.) -->
+[`field_name`, `field_name`]
+
+**Description:** Summarize here. Include visualizations, metrics, or links
+where necessary.
+
+**Impact on dataset use:** Summarize here. Include visualizations, metrics, or
+links where necessary.
+
+**Additional Notes:** add here
+
+#### Risk(s) and Mitigation(s)
+<!-- scope: microscope -->
+<!-- info: Summarize systemic or residual risks, performance expectations,
+trade-offs and caveats because of protected attributes in this dataset.
+
+Use additional notes to capture any other relevant information or
+considerations.
+
+Usage Note: Duplicate and complete the following for each protected attribute. -->
+**Protected Attribute**
+
+Summarize here. Include links and metrics where applicable.
+
+**Risk type:** [Description + Mitigations]
+
+**Risk type:** [Description + Mitigations]
+
+**Risk type:** [Description + Mitigations]
+
+**Trade-offs, caveats, and other considerations:** Summarize here. Include
+visualizations, metrics, or links where necessary.
+
+**Additional Notes:** Add here
+
+## Transformations
+<!-- info: The goal of this section is to elucidate if any biases
+may have been introduced during the transformation process(es) underwent
+to create this dataset.
+
+If any subsections below are covered by using Collibra data assets,
+simply provide a link to those corresponding data assets in the
+subsections below.
+
+If your transformation codebase or tooling already provides
+reasonably well understood information about the transformations
+applied to create this dataset, you may also simply want to
+provide relevant links in the subsections below.
+
+-->
+### Code Base and Existing Documentation
+<!-- scope: telescope -->
+<!-- info: Provide link(s) to transformation codebase and
+corresponding documentation. If the transformations are
+already well described there, do not repeat the information here.
+Simply refer the reader to go there for this information. -->
+See [[this GitHub repository]()] for more transformation code base and documentation.
+
+### Synopsis
+#### Transformation(s) Applied
+<!-- scope: telescope -->
+<!-- info: Select **all applicable** transformations
+that were applied to the dataset.
+
+Use section only if not already documented elsewhere!
+-->
+- Anomaly Detection
+- Cleaning Mismatched Values
+- Cleaning Missing Values
+- Converting Data Types
+- Data Aggregation
+- Dimensionality Reduction
+- Joining Input Sources
+- Redaction or Anonymization
+- Others (Please specify)
+
+#### Field(s) Transformed
+<!-- scope: periscope -->
+<!-- info: Provide the fields in the dataset that
+were transformed.
+
+Use section only if not already documented elsewhere!
+
+Use additional notes to capture any
+other relevant information or
+considerations.
+
+(Usage Note: Duplicate and complete
+the following for each transformation
+type applied. Include the data types to
+which fields were transformed.) -->
+**Transformation Type**
+
+| Field Name | Source and Target          |
+|------------|----------------------------|
+| Field Name | Source Field: Target Field |
+| Field Name | Source Field: Target Field |
+| ...        | ...                        |
+
+**Additional Notes:** Add here
+
+### Breakdown of Transformations
+<!-- info: Fill out relevant rows. -->
+#### Cleaning Missing Value(s)
+<!-- scope: telescope -->
+<!-- info: Which fields in the data were missing
+values? How many? -->
+Summarize here. Include links where available.
+
+**Field Name:** Count or description
+
+**Field Name:** Count or description
+
+**Field Name:** Count or description
+
+#### Method(s) Used
+<!-- scope: periscope -->
+<!-- info: How were missing values cleaned?
+What other choices were considered? -->
+Summarize here. Include links where necessary.
+
+#### Comparative Summary
+<!-- scope: microscope -->
+<!-- info: Why were missing values cleaned using
+this method (over others)? Provide
+comparative charts showing before
+and after missing values were cleaned. -->
+Summarize here. Include links, tables, visualizations where available.
+
+| **Field Name** | **Diff**      |
+|----------------|---------------|
+| Field Name     | Before: After |
+| Field Name     | Before: After |
+| ...            | ...           |
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Residual and Other Risk(s)
+<!-- scope: telescope -->
+<!-- info: What risks were introduced because of
+this transformation? Which risks were
+mitigated? -->
+Summarize here. Include links and metrics where applicable.
+
+- **Risk Type:** Description + Mitigations
+- **Risk Type:** Description + Mitigations
+- **Risk Type:** Description + Mitigations
+
+#### Human Oversight Measure(s)
+<!-- scope: periscope -->
+<!-- info: What human oversight measures,
+including additional testing,
+investigations and approvals were
+taken due to this transformation? -->
+Summarize here. Include links where available.
+
+#### Additional Considerations
+<!-- scope: microscope -->
+<!-- info: What additional considerations were
+made? -->
+Summarize here. Include links where available.
+
+#### Cleaning Mismatched Value(s)
+<!-- scope: telescope -->
+<!-- info: Which fields in the data were corrected
+for mismatched values? -->
+Summarize here. Include links where available.
+
+**Field Name:** Count or Description
+
+**Field Name:** Count or Description
+
+**Field Name:** Count or Description
+
+#### Method(s) Used
+<!-- scope: periscope -->
+<!-- info: How were incorrect or mismatched
+values cleaned? What other choices
+were considered? -->
+Summarize here. Include links where available.
+
+#### Comparative Summary
+<!-- scope: microscope -->
+<!-- info: Why were incorrect or mismatched
+values cleaned using this method (over
+others)? Provide a comparative
+analysis demonstrating before and
+after values were cleaned. -->
+Summarize here. Include links where available.
+
+| **Field Name** | **Diff**      |
+|----------------|---------------|
+| Field Name     | Before: After |
+| Field Name     | Before: After |
+| ...            | ...           |
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Residual and Other Risk(s)
+<!-- scope: telescope -->
+<!-- info: What risks were introduced because of
+this transformation? Which risks were
+mitigated? -->
+Summarize here. Include links and metrics where applicable.
+
+**Risk Type:** Description + Mitigations
+
+**Risk Type:** Description + Mitigations
+
+**Risk Type:** Description + Mitigations
+
+#### Human Oversight Measure(s)
+<!-- scope: periscope -->
+<!-- info: What human oversight measures,
+including additional testing,
+investigations and approvals were
+taken due to this transformation? -->
+Summarize here. Include links where available.
+
+#### Additional Considerations
+<!-- scope: microscope -->
+<!-- info: What additional considerations were made? -->
+Summarize here. Include links where available.
+
+#### Anomalies
+<!-- scope: telescope -->
+<!-- info: How many anomalies or outliers were
+detected?
+If at all, how were detected anomalies
+or outliers handled?
+Why or why not? -->
+Summarize here. Include links where available.
+
+**Field Name:** Count or Description
+
+**Field Name:** Count or Description
+
+**Field Name:** Count or Description
+
+#### Method(s) Used
+<!-- scope: periscope -->
+<!-- info: What methods were used to detect
+anomalies or outliers? -->
+Summarize here. Include links where necessary.
+
+**Platforms, tools, or libraries**
+
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+
+#### Comparative Summary
+<!-- scope: microscope -->
+<!-- info: Provide a comparative analysis
+demonstrating before and after
+anomaly handling measures. -->
+Summarize here. Include links, tables, visualizations where available.
+
+| **Field Name** | **Diff**      |
+|----------------|---------------|
+| Field Name     | Before: After |
+| Field Name     | Before: After |
+| ...            | ...           |
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Residual and Other Risk(s)
+<!-- scope: telescope -->
+<!-- info: What risks were introduced because of
+this transformation? Which risks were
+mitigated? -->
+Summarize here. Include links and metrics where applicable.
+
+**Risk Type:** Description + Mitigations
+
+**Risk Type:** Description + Mitigations
+
+**Risk Type:** Description + Mitigations
+
+#### Human Oversight Measure(s)
+<!-- scope: periscope -->
+<!-- info: What human oversight measures,
+including additional testing,
+investigations and approvals were
+taken due to this transformation? -->
+Summarize here. Include links where available.
+
+#### Additional Considerations
+<!-- scope: microscope -->
+<!-- info: What additional considerations were made? -->
+Summarize here. Include links where available.
+
+#### Dimensionality Reduction
+<!-- scope: telescope -->
+<!-- info: How many original features were
+collected and how many dimensions
+were reduced? -->
+Summarize here. Include links where available.
+
+**Field Name:** Count or Description
+
+**Field Name:** Count or Description
+
+**Field Name:** Count or Description
+
+#### Method(s) Used
+<!-- scope: periscope -->
+<!-- info: What methods were used to reduce the
+dimensionality of the data? What other
+choices were considered? -->
+Summarize here. Include links where
+necessary.
+
+**Platforms, tools, or libraries**
+
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+
+#### Comparative Summary
+<!-- scope: microscope -->
+<!-- info: Why were features reduced using this
+method (over others)? Provide
+comparative charts showing before
+and after dimensionality reduction
+processes. -->
+Summarize here. Include links, tables, visualizations where available.
+
+| **Field Name** | **Diff**      |
+|----------------|---------------|
+| Field Name     | Before: After |
+| Field Name     | Before: After |
+| ...            | ...           |
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Residual and Other Risks
+<!-- scope: telescope -->
+<!-- info: What risks were introduced because of
+this transformation? Which risks were
+mitigated? -->
+Summarize here. Include links and metrics where applicable.
+
+**Risk Type:** Description + Mitigations
+
+**Risk Type:** Description + Mitigations
+
+**Risk Type:** Description + Mitigations
+
+#### Human Oversight Measure(s)
+<!-- scope: periscope -->
+<!-- info: What human oversight measures,
+including additional testing,
+investigations and approvals were
+taken due to this transformation? -->
+Summarize here. Include links where available.
+
+#### Additional Considerations
+<!-- scope: microscope -->
+<!-- info: What additional considerations were made? -->
+Summarize here. Include links where available.
+
+#### Joining Input Sources
+<!-- scope: telescope -->
+<!-- info: What were the distinct input sources that were joined? -->
+Summarize here. Include links where available.
+
+**Field Name:** Count or Description
+
+**Field Name:** Count or Description
+
+**Field Name:** Count or Description
+
+#### Method(s) Used
+<!-- scope: periscope -->
+<!-- info: What are the shared columns of fields used to join these
+sources? -->
+Summarize here. Include links where necessary.
+
+**Platforms, tools, or libraries**
+
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+
+#### Comparative Summary
+<!-- scope: microscope -->
+<!-- info: Why were features joined using this
+method over others?
+
+Provide comparative charts showing
+before and after dimensionality
+reduction processes. -->
+Summarize here. Include links, tables, visualizations where available.
+
+| **Field Name** | **Diff**      |
+|----------------|---------------|
+| Field Name     | Before: After |
+| Field Name     | Before: After |
+| ...            | ...           |
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Residual and Other Risk(s)
+<!-- scope: telescope -->
+<!-- info: What risks were introduced because of
+this transformation? Which risks were
+mitigated? -->
+Summarize here. Include links and metrics where applicable.
+
+**Risk Type:** Description + Mitigations
+
+**Risk Type:** Description + Mitigations
+
+**Risk Type:** Description + Mitigations
+
+#### Human Oversight Measure(s)
+<!-- scope: periscope -->
+<!-- info: What human oversight measures,
+including additional testing,
+investigations and approvals were
+taken due to this transformation? -->
+Summarize here. Include links where
+available.
+
+#### Additional Considerations
+<!-- scope: microscope -->
+<!-- info: What additional considerations were
+made? -->
+Summarize here. Include links where
+available.
+
+#### Redaction or Anonymization
+<!-- scope: telescope -->
+<!-- info: Which features were redacted or
+anonymized? -->
+Summarize here. Include links where available.
+
+**Field Name:** Count or Description
+
+**Field Name:** Count or Description
+
+**Field Name:** Count or Description
+
+#### Method(s) Used
+<!-- scope: periscope -->
+<!-- info: What methods were used to redact or
+anonymize data? -->
+Summarize here. Include links where necessary.
+
+**Platforms, tools, or libraries**
+
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+
+#### Comparative Summary
+<!-- scope: microscope -->
+<!-- info: Why was data redacted or anonymized
+using this method over others? Provide
+comparative charts showing before
+and after redaction or anonymization
+process. -->
+Summarize here. Include links, tables, visualizations where available.
+
+| **Field Name** | **Diff**      |
+|----------------|---------------|
+| Field Name     | Before: After |
+| Field Name     | Before: After |
+| ...            | ...           |
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Residual and Other Risk(s)
+<!-- scope: telescope -->
+<!-- info: What risks were introduced because of
+this transformation? Which risks were
+mitigated? -->
+Summarize here. Include links and metrics where applicable.
+
+**Risk Type:** Description + Mitigations
+
+**Risk Type:** Description + Mitigations
+
+**Risk Type:** Description + Mitigations
+
+#### Human Oversight Measure(s)
+<!-- scope: periscope -->
+<!-- info: What human oversight measures,
+including additional testing,
+investigations and approvals were
+taken due to this transformation? -->
+Summarize here. Include links where available.
+
+#### Additional Considerations
+<!-- scope: microscope -->
+<!-- info: What additional considerations were
+made? -->
+Summarize here. Include links where available.
+
+#### Others (Please Specify)
+<!-- scope: telescope -->
+<!-- info: What was done? Which features or
+fields were affected? -->
+Summarize here. Include links where available.
+
+**Field Name:** Count or Description
+
+**Field Name:** Count or Description
+
+**Field Name:** Count or Description
+
+#### Method(s) Used
+<!-- scope: periscope -->
+<!-- info: What method were used? -->
+Summarize here. Include links where necessary.
+
+**Platforms, tools, or libraries**
+
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+
+#### Comparative Summary
+<!-- scope: microscope -->
+<!-- info: Why was this method used over
+others? Provide comparative charts
+showing before and after this
+transformation. -->
+Summarize here. Include links, tables, visualizations where available.
+
+| **Field Name** | **Diff**      |
+|----------------|---------------|
+| Field Name     | Before: After |
+| Field Name     | Before: After |
+| ...            | ...           |
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Residual and Other Risk(s)
+<!-- scope: telescope -->
+<!-- info: What risks were introduced because of
+this transformation? Which risks were
+mitigated? -->
+Summarize here. Include links and metrics where applicable.
+
+**Risk type:** [Description + Mitigations]
+
+**Risk type:** [Description + Mitigations]
+
+**Risk type:** [Description + Mitigations]
+
+#### Human Oversight Measure(s)
+<!-- scope: periscope -->
+<!-- info: What human oversight measures,
+including additional testing,
+investigations and approvals were
+taken due to this transformation? -->
+Summarize here. Include links where available.
+
+#### Additional Considerations
+<!-- scope: microscope -->
+<!-- info: What additional considerations were made? -->
+Summarize here. Include links where available.
+
+## Annotations and Labeling
+<!-- info: Fill this section if any human or algorithmic annotation tasks were
+performed in the creation of your dataset. -->
+
+### Annotation
+#### Task(s)
+<!-- scope: microscope -->
+<!-- info: Summarize each task type associated
+with annotations in the dataset.
+
+Use additional notes to capture any
+other relevant information or
+considerations.
+
+(Usage Note: Duplicate and complete
+the following for each task type.) -->
+**(Task Type)**
+
+**Task description:** Summarize here. Include links if available.
+
+**Task instructions:** Summarize here. Include links if available.
+
+**Methods used:** Summarize here. Include links if available.
+
+**Inter-rater adjudication policy:** Summarize here. Include links if
+available.
+
+<!-- Gold questions (i.e., questions with unambiguous, known answers)
+are questions that workers are only likely to get wrong if they
+don’t clearly understand the annotation criteria. -->
+**Golden questions:** Summarize here. Include links if available.
+
+**Additional notes:** Add here
+
+#### Characteristic(s)
+<!-- scope: periscope -->
+<!-- info: Describe relevant characteristics of annotations
+as indicated. For quality metrics, consider
+including accuracy, consensus accuracy, IRR
+(inter-rater reliability, sometimes called
+inter-annotator agreement or IAA, and its
+variants such as Cohen Kappa Score),
+xRR (cross replication reliability,
+sometimes called intra-rater reliability)
+at the appropriate granularity (e.g. across
+dataset, by annotator, by annotation, etc.).
+
+Use additional notes to capture any other
+relevant information or considerations.
+
+(Usage Note: Duplicate and complete the
+following for each annotation type.) -->
+| **(Annotation Type)**            | **Number** |
+|----------------------------------|------------|
+| Number of annotated examples     | 123456789  |
+| Total number of annotations      | 123456789  |
+| Average annotations per example  | 123456789  |
+| Number of annotators per example | 123456789  |
+| [Quality metric per granuality]  | 123456789  |
+| [Quality metric per granuality]  | 123456789  |
+| [Quality metric per granuality]  | 123456789  |
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Description(s)
+<!-- scope: microscope -->
+<!-- info: Provide descriptions of the annotations
+applied to the dataset. Include links
+and indicate platforms, tools or libraries
+used wherever possible.
+
+Use additional notes to capture any
+other relevant information or
+considerations.
+
+(Usage Note: Duplicate and complete
+the following for each annotation
+type.) -->
+**(Annotation Type)**
+
+**Description:** Description of annotations (labels, ratings) produced.
+Include how this was created or authored.
+
+**Link:** Relevant URL link.
+
+**Platforms, tools, or libraries:**
+
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+
+**Additional Notes:** Add here
+
+#### Distribution(s)
+<!-- scope: periscope -->
+<!-- info: Provide a distribution of annotations for each
+annotation or class of annotations using the
+format below.
+
+Use additional notes to capture any other
+relevant information or considerations.
+
+(Usage Note: Duplicate and complete the
+following for each annotation type.) -->
+| **(Annotation Type)**  | **Number**  |
+|------------------------|-------------|
+| Annotations (or Class) | 12345 (20%) |
+| Annotations (or Class) | 12345 (20%) |
+| Annotations (or Class) | 12345 (20%) |
+| Annotations (or Class) | 12345 (20%) |
+| Annotations (or Class) | 12345 (20%) |
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+### Human Annotators
+<!-- info: Fill this section if human annotators were used. -->
+#### Annotation Workforce Type
+<!-- scope: telescope -->
+<!-- info: Select **all applicable** annotation
+workforce types or methods used
+to annotate the dataset: -->
+- Annotation Target in Data
+- Machine-Generated
+- Annotations
+- Protected Attribute Annotations (Expert)
+- Protected Attribute Annotations (Non-Expert)
+- Protected Attribute Annotations (Employees)
+- Protected Attribute Annotations (Contractors)
+- Protected Attribute Annotations (Crowdsourcing)
+- Protected Attribute Annotations (Outsourced / Managed)
+- Teams
+- Unlabeled
+- Others (Please specify)
+
+#### Annotator Pool(s)
+<!-- scope: periscope -->
+<!-- info: Provide a brief description for each annotator
+pool performing the human annotation task.
+
+Use additional notes to capture any other
+relevant information or considerations.
+
+(Usage Note: Duplicate and complete the
+following for each annotation type.) -->
+**(Annotation Pool Name)**
+
+**Number of unique annotators:** Summarize here. Include links if available.
+
+**Task(s) completed:** Summarize here (See [annotation tasks](#tasks) section for full list of Annotation tasks).
+
+**Expertise of annotators:** Summarize here. Include links if available.
+
+**Description of annotators:** Summarize here. Include links if available.
+
+**Summary of general (non task specific) annotation instructions:** Summarize here. Include links if
+available.
+
+**Summary of annotator's responses to gold questions:** Summarize here. Include links if available.
+
+**Annotation platforms:** Summarize here. Include links if available.
+
+**Additional Notes:** Add here
+
+#### Language(s)
+<!-- scope: telescope -->
+<!-- info: General information about annotation workforce
+
+Use additional notes to capture any
+other relevant information or
+considerations.
+
+(Usage Note: Duplicate and
+complete the following for each
+annotation type.) -->
+**(Annotator Languages Spoken)**
+
+- Language [Percentage %]
+- Language [Percentage %]
+- Language [Percentage %]
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Location(s)
+<!-- scope: periscope -->
+<!-- info: General information about annotation workforce
+
+Use additional notes to capture any other
+relevant information or considerations.
+
+(Usage Note: Duplicate and complete the
+following for each annotation type.) -->
+**(Annotator Locations of Upbringing)**
+
+- Location [Percentage %]
+- Location [Percentage %]
+- Location [Percentage %]
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+**(Annotator Current Locations of Residence)**
+
+- Location [Percentage %]
+- Location [Percentage %]
+- Location [Percentage %]
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Gender(s)
+<!-- scope: microscope -->
+<!-- info: General information about annotation workforce
+
+Use additional notes to capture any
+other relevant information or
+considerations.
+
+(Usage Note: Duplicate and complete
+the following for each annotation
+type.) -->
+**(Annotator Genders)**
+
+- Gender [Percentage %]
+- Gender [Percentage %]
+- Gender [Percentage %]
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+## Validation Types
+<!-- info: Fill this section if the data in the dataset was validated during
+or after the creation of your dataset. -->
+#### Method(s)
+<!-- scope: telescope -->
+<!-- info: Select **all applicable**: -->
+- Data Type Validation
+- Range and Constraint Validation
+- Code/cross-reference Validation
+- Structured Validation
+- Consistency Validation
+- Not Validated
+- Others (Please Specify)
+
+#### Breakdown(s)
+<!-- scope: periscope -->
+<!-- info: Provide a description of the fields and data
+points that were validated.
+
+Use additional notes to capture any other
+relevant information or considerations.
+
+(Usage Note: Duplicate and complete the
+following for each validator type.) -->
+**(Validation Type)**
+
+**Number of Data Points Validated:** 12345
+
+**Fields Validated**
+Field | Count (if available)
+--- | ---
+Field | 123456
+Field | 123456
+Field | 123456
+
+**Above:** Provide a caption for the above table or visualization.
+
+#### Description(s)
+<!-- scope: microscope -->
+<!-- info: Provide a description of the methods used to
+validate the dataset.
+
+Use additional notes to capture any other
+relevant information or considerations.
+
+(Usage Note: Duplicate and complete the
+following for each validator type.) -->
+**(Validation Type)**
+
+**Method:** Describe the validation method here. Include links where
+necessary.
+
+**Platforms, tools, or libraries:**
+
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+- Platform, tool, or library: Write description here
+
+**Validation Results:** Provide results, outcomes, and actions taken because
+of the validation. Include visualizations where available.
+
+**Additional Notes:** Add here
+
+### Description of Human Validators
+<!-- info: Fill this section if the dataset was validated using human
+validators.  Human validation is a form of annotation (for example,
+annotating if a image satisfies a particular set of requirements).
+Thus, this section is quite similar to the Description of Human Annotators
+section. -->
+#### Characteristic(s)
+<!-- scope: periscope -->
+<!-- info: Provide characteristics of the validator
+pool(s). Use additional notes to capture any
+other relevant information or considerations. -->
+**(Validation Type)**
+- Unique validators: 12345
+- Number of examples per validator: 123456
+- Average cost/task/validator: $$$
+- Training provided: Y/N
+- Expertise required: Y/N
+
+#### Description(s)
+<!-- scope: microscope -->
+<!-- info: Provide a brief description of the validator
+pool(s). Use additional notes to capture any
+other relevant information or considerations.
+
+(Usage Note: Duplicate and complete the
+following for each validator type.) -->
+**(Validation Type)**
+
+**Validator description:** Summarize here. Include links if available.
+
+**Training provided:** Summarize here. Include links if available.
+
+**Validator selection criteria:** Summarize here. Include links if available.
+
+**Training provided:** Summarize here. Include links if available.
+
+**Additional Notes:** Add here
+
+#### Language(s)
+<!-- scope: telescope -->
+<!-- info: Provide validator distributions.
+Use additional notes to capture any other relevant information or
+considerations.
+
+(Usage Note: Duplicate and complete the following for each annotation type.)-->
+**(Validation Type)**
+
+- Language [Percentage %]
+- Language [Percentage %]
+- Language [Percentage %]
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Location(s)
+<!-- scope: periscope -->
+<!-- info: Provide validator distributions.
+Use additional notes to capture any other relevant information or
+considerations.
+
+(Usage Note: Duplicate and complete the following for each annotation type.)-->
+**(Validation Type)**
+
+- Location [Percentage %]
+- Location [Percentage %]
+- Location [Percentage %]
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Gender(s)
+<!-- scope: microscope -->
+<!-- info: Provide validator distributions.
+Use additional notes to capture any other relevant information or
+considerations.
+
+(Usage Note: Duplicate and complete the following for each annotation type.)-->
+**(Validation Type)**
+
+- Gender [Percentage %]
+- Gender [Percentage %]
+- Gender [Percentage %]
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+## Sampling Methods
+<!-- info: The goal of this section is to help consumers identify potential
+biases introduced by sampling to create this dataset.
+
+Fill out the following block if your dataset employs any sampling
+methods. -->
+#### Method(s) Used
+<!-- scope: telescope -->
+<!-- info: Select **all applicable** methods used in the creation of this
+dataset: -->
+- Cluster Sampling
+- Haphazard Sampling
+- Multi-stage Sampling
+- Random Sampling
+- Retrospective Sampling
+- Stratified Sampling
+- Systematic Sampling
+- Weighted Sampling
+- Unknown
+- Unsampled
+- Others (Please specify)
+
+#### Characteristic(s)
+<!-- scope: periscope -->
+<!-- info: Provide characteristics of each sampling
+method used.
+
+Use additional notes to capture any other
+relevant information or considerations.
+
+(Usage Note: Duplicate and complete the
+following for each sampling method
+used.) -->
+| **(Sampling Type)**   | **Number**             |
+|-----------------------|------------------------|
+| Upstream Source       | Write here             |
+| Total data sampled    | 123m                   |
+| Sample size           | 123                    |
+| Threshold applied     | 123k units at property |
+| Sampling rate         | 123                    |
+| Sample mean           | 123                    |
+| Sample std. dev       | 123                    |
+| Sampling distribution | 123                    |
+| Sampling variation    | 123                    |
+| Sample statistic      | 123                    |
+
+**Above:** Provide a caption for the above table or visualization.
+
+**Additional Notes:** Add here
+
+#### Sampling Criteria
+<!-- scope: microscope -->
+<!-- info: Describe the criteria used to sample data from
+upstream sources.
+
+Use additional notes to capture any other
+relevant information or considerations. -->
+- **Sampling method:** Summarize here. Include links where applicable.
+- **Sampling method:** Summarize here. Include links where applicable.
+- **Sampling method:** Summarize here. Include links where applicable.
+
+## Glossary
+### Concepts and Definitions referenced in this Data Card
+<!-- info: Use this space to include the expansions and definitions of any
+acronyms, concepts, or terms of art used across the Data Card.
+Use standard definitions where possible. Include the source of the definition
+where indicated. If you are using an interpretation,
+adaptation, or modification of the standard definition for the purposes of your
+Data Card or dataset, include your interpretation as well.
+
+If this information already exists as part of another document or
+in a Collibra data asset, a link to that will suffice.
+-->
+#### Term of Art
+Definition: Write here
+
+Source: Write here and share link
+
+Interpretation: Write here
+
+#### Term of Art
+Definition: Write here
+
+Source: Write here and share link
+
+Interpretation: Write here
+
+#### Term of Art
+Definition: Write here
+
+Source: Write here and share link
+
+Interpretation: Write here
+
+#### Term of Art
+Definition: Write here
+
+Source: Write here and share link
+
+Interpretation: Write here
+
+#### Term of Art
+Definition: Write here
+
+Source: Write here and share link
+
+Interpretation: Write here
+
+#### Term of Art
+Definition: Write here
+
+Source: Write here and share link
+
+Interpretation: Write here
+
+#### Term of Art
+Definition: Write here
+
+Source: Write here and share link
+
+Interpretation: Write here
+
+#### Term of Art
+Definition: Write here
+
+Source: Write here and share link
+
+Interpretation: Write here
+
+#### Term of Art
+Definition: Write here
+
+Source: Write here and share link
+
+Interpretation: Write here
+
+#### Term of Art
+Definition: Write here
+
+Source: Write here and share link
+
+Interpretation: Write here
+
+#### Term of Art
+Definition: Write here
+
+Source: Write here and share link
+
+Interpretation: Write here
+
+#### Term of Art
+Definition: Write here
+
+Source: Write here and share link
+
+Interpretation: Write here
+
+## Reflections on Data
+<!-- info: Use this space to include any additional information about the
+dataset that has not been captured by the Data Card. For example,
+does the dataset contain data that might be offensive, insulting, threatening,
+or might otherwise cause anxiety? If so, please contact the appropriate parties
+to mitigate any risks. -->
+### Title
+Write notes here.
+
+### Title
+Write notes here.
+
+### Title
+Write notes here.
diff --git a/templates/Model Card - Zalando Template.md b/templates/Model Card - Zalando Template.md
new file mode 100644
index 0000000..70fd378
--- /dev/null
+++ b/templates/Model Card - Zalando Template.md	
@@ -0,0 +1,207 @@
+<!-- info: This model card template was
+derived for usage at Zalando based on existing
+[Huggingface](https://huggingface.co/docs/hub/model-cards) and
+[Google](https://modelcards.withgoogle.com/about) templates.
+-->
+
+<h1>Model Name (Acronym)</h1>
+
+Model card contributions and feedback are welcome!
+
+## Template Version
+<!-- scope: telescope -->
+<!-- info: link to model card version - we recommend using git tags / releases -->
+[0.2.2]()
+
+## Overview
+
+#### Last Update
+<!-- info: Remember to add reference to version control document or system. -->
+**DD/MM/YY**
+
+#### Model Card Author(s)
+<!-- info: Authors should get credit in overview section
+
+Select one or more roles per author and reference author's
+emails to ease communication and add transparency. -->
+
+- **Name, Team:** (Owner / Contributor / Manager)
+- **Name, Team:** (Owner / Contributor / Manager)
+- **Name, Team:** (Owner / Contributor / Manager)
+
+## Model Overview
+* Description
+<!-- info: Brief (max 200 words) description of the model architecture and the task(s) it was trained to solve. -->
+
+#### Status
+<!-- scope: telescope -->
+<!-- info: Select **one:** -->
+**Status Date:** DD/MM/YYYY
+
+**Under Preparation** - The model is still under active development
+and is not yet ready for use due to active "dev" updates.
+
+**Regularly Updated** - New versions of the model
+have been or will continue to be made available.
+
+**Actively Maintained** - No new versions will be made
+available, but this model will
+be actively maintained.
+
+**Limited Maintenance** - The model will not be updated,
+but any technical issues will be
+addressed.
+
+**Deprecated** - This model is obsolete or is
+no longer being maintained.
+
+### Developers
+- **Name, Team**
+- **Name, Team**
+
+### Owners
+<!-- info: Remember to reference developers and owners emails. -->
+- **Team Name, Contact Person**
+
+### Risk classification
+
+<!-- info: Use the AI Act risk classification criteria found here: http://ai-act.eu/risk.
+Reference assesment document if possible. -->
+- High / Limited / Minimal
+
+### Version Details and Artifacts
+<!-- scope: periscope -->
+<!-- info: Provide details about the current model version
+and which model version the current model card corresponds to.
+
+For models without version number, use "Not currently tracked"
+but be sure to track the release date of the model.
+-->
+**Current Model Version:**
+
+**Model Version Release Date:**
+
+**Model Version for last Model Card Update:**
+
+**Artifacts:**
+
+
+- Model weights (e.g. S3 bucket path)
+- Model config (e.g. S3 bucket path)
+
+### Github
+<!-- info: Remember to link repositories. -->
+- Repository_1
+- Repository_2
+
+### References
+Example references:
+
+- Paper/Documentation Link
+- Initiative Link
+- API Link
+
+## Intended Use and Known Applications
+#### Intended Use
+<!-- info: This section focuses on the initial purpose and/or reasoning
+for creating the model.-->
+
+* Description
+
+#### Known Applications
+<!-- info: Fill out the following section if the model has any
+current known usages.
+-->
+
+| **Application**   | **Purpose of Model Usage**                                                 | **[AI Act Risk](https://digital-strategy.ec.europa.eu/en/policies/regulatory-framework-ai)** |
+|-------------------|----------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
+| [Application 1]() | Foundation model providing customer embeddings for fraud detection scoring | High                                                                                         |
+| [Application 2]() | Customer embeddings used directly as features for recommendation engine    | Limited                                                                                      |
+
+Note, this table may not be exhaustive.  Model users and documentation consumers at large
+are highly encouraged to contribute known usages.
+
+#### Out Of Scope Uses
+Provide potential applications and/or use cases for which use of the model is not suitable.
+
+## Risks and Ethical Considerations
+This section should cover topics related to known biases, security, privacy and other risks related to use of the model. Please provide an introductory paragraph before listing risks and cosnsiderations. Such introduction should explain
+how the risks / ethical considerations were identified
+and wheter, and if so which, risks teams were involved in identifying the issues and coming up with the mitigation strategies.
+
+#### Risk / Consideration
+
+Description
+
+**Mitigation strategy**:
+
+Description
+
+#### Risk / Consideration
+
+Description
+
+**Mitigation strategy**:
+
+Description
+
+## Training
+<!-- info: This section should include overview regarding training process such as training dataset(s), training task (ex. next token prediciton, pixel-wise classification). -->
+
+### Datasets
+Datasets should be compiled in a table with columns and rows:
+
+| Name  | Location | Sensitive*  | Size   | Documentation
+|---|---|---|---|---|
+Name | Location (e.g. S3 bucket) | Yes / No | # of samples | Link (e.g. Dataset Card)
+
+
+(*): Requires a special Data Processing Request
+## Evaluation
+<!-- info: Remember to reference metrics definitions and results variance (if available.) -->
+This section should include overview of evaluation process such as evaluation dataset(s), metrics and quantitive results.
+
+
+### Datasets
+Datasets should be compiled in a table with columns and rows:
+
+| Name  | Location | Sensitive*  | Size   | Documentation
+|---|---|---|---|---|
+Name | Location (e.g S3 bucket) | Yes / No | # of samples | Link (e.g Dataset Card)
+
+(*): Requires a special Data Processing Request
+
+### Quantitive Results
+<!-- info: Please provide rationales for selected metrics.  -->
+* Dataset:
+    * **Metric: Result**
+    * **Metric: Result**
+
+* Dataset:
+    * **Metric: Result**
+    * **Metric: Result**
+
+## Caveats and Recommendations
+This section should cover shortcomings and recommendations related to current approach such as:
+
+* scalability
+* robustness
+* deployment safety and readiness
+* training / evaluation data
+
+
+Additionaly plans or ideas for future work could be discussed (e.g. incorporate new data source or use a bigger model).
+
+## Energy Requirements
+<!-- scope: telescope -->
+<!-- info: estimate the total energy footprint of this model.-->
+
+| Category                            | Estimated footprint       |
+|-------------------------------------|---------------------------|
+| Total training time                 | 118 days, 5 hours, 41 min |
+| Total number of GPU hours           | 1,082,990 hours           |
+| Total energy used                   | 433,196 kW                |
+| GPU models used                     | Nvidia A100 80GB          |
+| Carbon intensity of the energy grid | 57 gCO2eq/kWh             |
+
+Example taken directly from [Luccioni et al.](https://arxiv.org/pdf/2211.02001.pdf).

From ba11dcdb31c7ff10d187ffc1666e81b811206ddf Mon Sep 17 00:00:00 2001
From: Alex Loosley <alex.loosley@zalando.de>
Date: Thu, 31 Aug 2023 13:45:17 +0200
Subject: [PATCH 2/3] contributors

---
 templates/Data Card - Zalando Template.md  | 2 ++
 templates/Model Card - Zalando Template.md | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/templates/Data Card - Zalando Template.md b/templates/Data Card - Zalando Template.md
index b361a46..8944a91 100644
--- a/templates/Data Card - Zalando Template.md	
+++ b/templates/Data Card - Zalando Template.md	
@@ -2,6 +2,8 @@
 derived for usage at Zalando based on existing
 [Huggingface](https://huggingface.co/docs/hub/datasets-cards) and
 [Google](https://sites.research.google/datacardsplaybook/) templates.
+
+Contributors: Alex Loosley, Rocco Maresca, Pak-Hang Wong, Håkan Jonsson
 -->
 
 <h1>Dataset Name (Acronym)</h1>
diff --git a/templates/Model Card - Zalando Template.md b/templates/Model Card - Zalando Template.md
index 70fd378..29391b4 100644
--- a/templates/Model Card - Zalando Template.md	
+++ b/templates/Model Card - Zalando Template.md	
@@ -2,6 +2,8 @@
 derived for usage at Zalando based on existing
 [Huggingface](https://huggingface.co/docs/hub/model-cards) and
 [Google](https://modelcards.withgoogle.com/about) templates.
+
+Contributors: Alex Loosley, Rocco Maresca, Pak-Hang Wong, Håkan Jonsson
 -->
 
 <h1>Model Name (Acronym)</h1>

From 823104559b33260786c3c93aed99fb303573c983 Mon Sep 17 00:00:00 2001
From: Alex Loosley <aloosley@alumni.brown.edu>
Date: Mon, 4 Sep 2023 10:28:33 +0200
Subject: [PATCH 3/3] switch from unit of power to unit of energy

---
 templates/Model Card - Zalando Template.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates/Model Card - Zalando Template.md b/templates/Model Card - Zalando Template.md
index 29391b4..60c4131 100644
--- a/templates/Model Card - Zalando Template.md	
+++ b/templates/Model Card - Zalando Template.md	
@@ -202,7 +202,7 @@ Additionaly plans or ideas for future work could be discussed (e.g. incorporate
 |-------------------------------------|---------------------------|
 | Total training time                 | 118 days, 5 hours, 41 min |
 | Total number of GPU hours           | 1,082,990 hours           |
-| Total energy used                   | 433,196 kW                |
+| Total energy used                   | 433,196 kWh               |
 | GPU models used                     | Nvidia A100 80GB          |
 | Carbon intensity of the energy grid | 57 gCO2eq/kWh             |