Model Card Restructure & edits (#56)

- Model Card Restructure & edits (f7df57cf022ab72519932532c2aa7577c479d5a6)


Co-authored-by: Ezi Ozoani <Ezi@users.noreply.huggingface.co>

README.md

@@ -59,168 +59,53 @@ pipeline_tag: text-generation
 
 Version 1.0 / 26.May.2022
 
+# Model Card for Bloom-560m
+
+<!-- Provide a quick summary of what the model is/does. -->
+
 ## Table of Contents
 1. [Model Details](#model-details)
 2. [Uses](#uses)
-3. [Training Data](#training-data)
-4. [Risks and Limitations](#risks-and-limitations)
-5. [Evaluation](#evaluation)
-6. [Recommendations](#recommendations)
-7. [Glossary and Calculations](#glossary-and-calculations)
-8. [More Information](#more-information)
-9. [Model Card Authors](#model-card-authors)
+3. [Bias, Risks, and Limitations](#bias-risks-and-limitations)
+  4. [Recommendations](#recommendations)
+5. [Training Data](#training-data)
+6. [Evaluation](#evaluation)
+7. [Environmental Impact](#environmental-impact)
+8. [Technical Specifications](#techincal-specifications)
+9. [Citation](#citation)
+10. [Glossary and Calculations](#glossary-and-calculations)
+11. [More Information](#more-information)
+12. [Model Card Authors](#model-card-authors)
+13. [Model Card Contact](#model-card-contact)
 
 ## Model Details  
 
-### Basics
+### Model Description
 *This section provides information for anyone who wants to know about the model.*
-
-<details>
-<summary>Click to expand</summary> <br/>
-    
-**Developed by:** BigScience ([website](https://bigscience.huggingface.co))
-
-* All collaborators are either volunteers or have an agreement with their employer. *(Further breakdown of participants forthcoming.)*
     
-**Model Type:** Transformer-based Language Model
-
-**Version:** 1.0.0
-
-**Languages:** Multiple; see [training data](#training-data)
-
-**License:** RAIL License v1.0 ([link](https://huggingface.co/spaces/bigscience/license))
-
-**Release Date Estimate:** Monday, 11.July.2022
-
-**Send Questions to:** bigscience-contact@googlegroups.com
-
-**Cite as:** BigScience, _BigScience Language Open-science Open-access Multilingual (BLOOM) Language Model_. International, May 2021-May 2022
-
-**Funded by:** 
-    
-* The French government.
-
-* Hugging Face ([website](https://huggingface.co)).
-
-* Organizations of contributors.  *(Further breakdown of organizations forthcoming.)*
-
-</details>
-
-### Technical Specifications
-*This section provides information for people who work on model development.*
-
-<details>
-<summary>Click to expand</summary><br/>
-
-Please see [the BLOOM training README](https://github.com/bigscience-workshop/bigscience/tree/master/train/tr11-176B-ml#readme) for full details on replicating training.
-
-**Model Architecture:** Modified from Megatron-LM GPT2 (see [paper](https://arxiv.org/abs/1909.08053), [BLOOM Megatron code](https://github.com/bigscience-workshop/Megatron-DeepSpeed)):
-
-* Decoder-only architecture
-
-* Layer normalization applied to word embeddings layer (`StableEmbedding`; see [code](https://github.com/facebookresearch/bitsandbytes), [paper](https://arxiv.org/pdf/2110.02861.pdf))
-
-* ALiBI positional encodings (see [paper](https://arxiv.org/pdf/2108.12409.pdf)), with GeLU activation functions
-
-* 559,214,592 parameters:
-
-    * 256,901,120 embedding parameters
-
-    * 24 layers, 16 attention heads
-
-    * Hidden layers are 1024-dimensional
+- **Developed by:** BigScience ([website](https://bigscience.huggingface.co))
 
-    * Sequence length of 2048 tokens (see [BLOOM tokenizer](https://huggingface.co/bigscience/tokenizer), [tokenizer description](#tokenization))
-
-**Objective Function:** Cross Entropy with mean reduction (see [API documentation](https://pytorch.org/docs/stable/generated/torch.nn.CrossEntropyLoss.html#torch.nn.CrossEntropyLoss)).
+  * All collaborators are either volunteers or have an agreement with their employer. *(Further breakdown of participants forthcoming.)*
     
-**Compute infrastructure:** Jean Zay Public Supercomputer, provided by the French government (see [announcement](https://www.enseignementsup-recherche.gouv.fr/fr/signature-du-marche-d-acquisition-de-l-un-des-supercalculateurs-les-plus-puissants-d-europe-46733)).
-
-* Hardware: 384 A100 80GB GPUs (48 nodes):
+- **Model Type:** Transformer-based Language Model
+- **Version:** 1.0.0
+- **Languages:** Multiple; see [training data](#training-data)
+- **License:** RAIL License v1.0 ([link](https://huggingface.co/spaces/bigscience/license))
+- **Release Date Estimate:** Monday, 11.July.2022
+- **Funded by:** 
     
-    * Additional 32 A100 80GB GPUs (4 nodes) in reserve
-
-    *  8 GPUs per node Using NVLink 4 inter-gpu connects, 4 OmniPath links
-
-    *   CPU: AMD
-
-    *   CPU memory: 512GB per node
+  * The French government.
 
-    *   GPU memory: 640GB per node
+  * Hugging Face ([website](https://huggingface.co)).
 
-    *   Inter-node connect: Omni-Path Architecture (OPA)
-
-    *   NCCL-communications network: a fully dedicated subnet
-
-    *   Disc IO network: shared network with other types of nodes
-
-* Software:
-  
-    *   Megatron-DeepSpeed ([Github link](https://github.com/bigscience-workshop/Megatron-DeepSpeed))
-
-    *   DeepSpeed ([Github link](https://github.com/microsoft/DeepSpeed))
-
-    *   PyTorch (pytorch-1.11 w/ CUDA-11.5; see [Github link](https://github.com/pytorch/pytorch))
-
-    *   apex ([Github link](https://github.com/NVIDIA/apex))
+  * Organizations of contributors.  *(Further breakdown of organizations forthcoming.)*
 
 
-#### **Training**
-
-Training logs: [Tensorboard link](https://huggingface.co/bigscience/tr11e-350M-logs)
-
-- Training throughput: About 150 TFLOPs per GPU
-
-- Number of epochs: 1 (*current target*)
-
-- Dates:
-    
-    - Started 11th March, 2022 11:42am PST
-
-    - Ended 5th July, 2022
-
-- Estimated cost of training: Equivalent of $2-5M in cloud computing (including preliminary experiments and other model sizes)
-
-- Server training location: Île-de-France, France
-
-#### **Tokenization**
-    
-The BLOOM tokenizer ([link](https://huggingface.co/bigscience/tokenizer)) is a learned subword tokenizer trained using:
-    
-- A byte-level Byte Pair Encoding (BPE) algorithm 
-
-- A simple pre-tokenization rule, no normalization
-
-- A vocabulary size of 250,680
-
-It was trained on a subset of a preliminary version of the corpus using alpha-weighting per language.    
-    
-</details>
-
-
-### Environmental Impact
-
-<details>
-<summary>Click to expand</summary><br/>
-
-The training supercomputer, Jean Zay ([website](http://www.idris.fr/eng/jean-zay/jean-zay-presentation-eng.html)), uses mostly nuclear energy. The heat generated by it is reused for heating campus housing.
-    
-**Estimated carbon emissions:**  *(Forthcoming upon completion of training.)*
-    
-**Estimated electricity usage:** *(Forthcoming upon completion of training.)*
-
-
-</details>
-<p>&nbsp;</p>
-
 ## Uses
 
 *This section addresses questions around how the model is intended to be used, discusses the foreseeable users of the model (including those affected by the model), and describes uses that are considered out of scope or misuse of the model. 
 It provides information for anyone considering using the model or who is affected by the model.*
 
-
-<details>
-<summary>Click to expand</summary><br/>
     
 ### Intended Use
 
@@ -307,15 +192,49 @@ Intentionally using the model for harm, violating [human rights](#human-rights),
 
 -   People and groups whose original work is included in the LLM
     
-</details>
-<p>&nbsp;</p>
+
+
+## Bias, Risks and Limitations
+*This section identifies foreseeable harms and misunderstandings.*
+
+    
+Model may:
+
+-   Overrepresent some viewpoints and underrepresent others
+
+-   Contain stereotypes
+  
+-   Contain [personal information](#personal-data-and-information)
+
+-   Generate:
+
+    -   Hateful, abusive, or violent language
+
+    -   Discriminatory or prejudicial language
+
+    -   Content that may not be appropriate for all settings, including sexual content
+
+-   Make errors, including producing incorrect information as if it were factual
+
+-   Generate irrelevant or repetitive outputs
+
+### Recommendations
+
+*This section provides information on warnings and potential mitigations.*
+
+
+-   Indirect users should be made aware when the content they're working with is created by the LLM.
+
+-   Users should be aware of [Risks and Limitations](#risks-and-limitations), and include an appropriate age disclaimer or blocking interface as necessary.
+
+-   Models pretrained with the LLM should include an updated Model Card.
+
+-   Users of the model should provide mechanisms for those affected to provide feedback, such as an email address for comments.
+
 
 ## Training Data
 *This section provides a high-level overview of the training data. It is relevant for anyone who wants to know the basics of what the model is learning.*
 
-
-<details>
-<summary>Click to expand</summary><br/>
     
 Details for each dataset are provided in individual [Data Cards](https://huggingface.co/spaces/bigscience/BigScienceCorpus).
 
@@ -335,9 +254,7 @@ The pie chart shows the distribution of languages in training data.
 ![pie chart showing the distribution of languages in training data](https://github.com/bigscience-workshop/model_card/blob/main/assets/data/pie_chart.svg?raw=true)
 
 
-The following table shows the further distribution of Niger-Congo and Indic languages in the training data.
-<details>
-<summary>Click to expand</summary><br/>
+**The following table shows the further distribution of Niger-Congo and Indic languages in the training data.**
     
 | Niger Congo    | Percentage |         | Indic     | Percentage |
 |----------------|------------ |------  |-----------|------------|
@@ -361,11 +278,10 @@ The following table shows the further distribution of Niger-Congo and Indic lang
 | Kinyarwanda    | 0.003      |
 | Yoruba         | 0.006      |
 | Swahili        | 0.02       |
-</details>
 
-The following table shows the distribution of programming languages.
-<details>
-<summary>Click to expand</summary><br/>
+
+**The following table shows the distribution of programming languages.**
+
     
 | Extension      | Language   | Number of files |
 |----------------|------------|-----------------|
@@ -395,44 +311,11 @@ The following table shows the distribution of programming languages.
 | php5           | PHP        | 166             |
 | php4           | PHP        | 29              |
     
-</details>    
-</details>
-<p>&nbsp;</p>
-
-## Risks and Limitations
-*This section identifies foreseeable harms and misunderstandings.*
-
-<details>
-<summary>Click to expand</summary><br/>
-    
-Model may:
 
--   Overrepresent some viewpoints and underrepresent others
-
--   Contain stereotypes
-  
--   Contain [personal information](#personal-data-and-information)
-
--   Generate:
-
-    -   Hateful, abusive, or violent language
-
-    -   Discriminatory or prejudicial language
-
-    -   Content that may not be appropriate for all settings, including sexual content
-
--   Make errors, including producing incorrect information as if it were factual
-
--   Generate irrelevant or repetitive outputs
-</details>
-<p>&nbsp;</p>
 
 ## Evaluation
 *This section describes the evaluation protocols and provides the results.*
 
-<details>
-<summary>Click to expand</summary><br/>
-
 ### Metrics 
 *This section describes the different ways performance is calculated and why.*
     
@@ -469,36 +352,113 @@ As of 25.May.2022, 15:00 PST:
 
 (More evaluation scores forthcoming at the end of model training.)
 
-</details>
-<p>&nbsp;</p>
 
-## Recommendations
 
-*This section provides information on warnings and potential mitigations.*
 
+## Environmental Impact
 
-<details>
-<summary>Click to expand</summary><br/>
+The training supercomputer, Jean Zay ([website](http://www.idris.fr/eng/jean-zay/jean-zay-presentation-eng.html)), uses mostly nuclear energy. The heat generated by it is reused for heating campus housing.
+    
+**Estimated carbon emissions:**  *(Forthcoming upon completion of training.)*
+    
+**Estimated electricity usage:** *(Forthcoming upon completion of training.)*
 
--   Indirect users should be made aware when the content they're working with is created by the LLM.
 
--   Users should be aware of [Risks and Limitations](#risks-and-limitations), and include an appropriate age disclaimer or blocking interface as necessary.
+## Technical Specifications
+*This section provides information for people who work on model development.*
 
--   Models pretrained with the LLM should include an updated Model Card.
+Please see [the BLOOM training README](https://github.com/bigscience-workshop/bigscience/tree/master/train/tr11-176B-ml#readme) for full details on replicating training.
 
--   Users of the model should provide mechanisms for those affected to provide feedback, such as an email address for comments.
+**Model Architecture:** Modified from Megatron-LM GPT2 (see [paper](https://arxiv.org/abs/1909.08053), [BLOOM Megatron code](https://github.com/bigscience-workshop/Megatron-DeepSpeed)):
 
-</details>
-<p>&nbsp;</p>
+* Decoder-only architecture
 
-## Glossary and Calculations
+* Layer normalization applied to word embeddings layer (`StableEmbedding`; see [code](https://github.com/facebookresearch/bitsandbytes), [paper](https://arxiv.org/pdf/2110.02861.pdf))
 
-*This section defines common terms and how metrics are calculated.*
+* ALiBI positional encodings (see [paper](https://arxiv.org/pdf/2108.12409.pdf)), with GeLU activation functions
+
+* 559,214,592 parameters:
+
+    * 256,901,120 embedding parameters
+
+    * 24 layers, 16 attention heads
+
+    * Hidden layers are 1024-dimensional
+
+    * Sequence length of 2048 tokens (see [BLOOM tokenizer](https://huggingface.co/bigscience/tokenizer), [tokenizer description](#tokenization))
+
+**Objective Function:** Cross Entropy with mean reduction (see [API documentation](https://pytorch.org/docs/stable/generated/torch.nn.CrossEntropyLoss.html#torch.nn.CrossEntropyLoss)).
+    
+**Compute infrastructure:** Jean Zay Public Supercomputer, provided by the French government (see [announcement](https://www.enseignementsup-recherche.gouv.fr/fr/signature-du-marche-d-acquisition-de-l-un-des-supercalculateurs-les-plus-puissants-d-europe-46733)).
+
+* Hardware: 384 A100 80GB GPUs (48 nodes):
+    
+    * Additional 32 A100 80GB GPUs (4 nodes) in reserve
+
+    *  8 GPUs per node Using NVLink 4 inter-gpu connects, 4 OmniPath links
+
+    *   CPU: AMD
+
+    *   CPU memory: 512GB per node
+
+    *   GPU memory: 640GB per node
+
+    *   Inter-node connect: Omni-Path Architecture (OPA)
+
+    *   NCCL-communications network: a fully dedicated subnet
 
+    *   Disc IO network: shared network with other types of nodes
 
+* Software:
+  
+    *   Megatron-DeepSpeed ([Github link](https://github.com/bigscience-workshop/Megatron-DeepSpeed))
 
-<details>
-<summary>Click to expand</summary><br/>
+    *   DeepSpeed ([Github link](https://github.com/microsoft/DeepSpeed))
+
+    *   PyTorch (pytorch-1.11 w/ CUDA-11.5; see [Github link](https://github.com/pytorch/pytorch))
+
+    *   apex ([Github link](https://github.com/NVIDIA/apex))
+
+
+### **Training**
+
+Training logs: [Tensorboard link](https://huggingface.co/bigscience/tr11e-350M-logs)
+
+- Training throughput: About 150 TFLOPs per GPU
+
+- Number of epochs: 1 (*current target*)
+
+- Dates:
+    
+    - Started 11th March, 2022 11:42am PST
+
+    - Ended 5th July, 2022
+
+- Estimated cost of training: Equivalent of $2-5M in cloud computing (including preliminary experiments and other model sizes)
+
+- Server training location: Île-de-France, France
+
+### **Tokenization**
+    
+The BLOOM tokenizer ([link](https://huggingface.co/bigscience/tokenizer)) is a learned subword tokenizer trained using:
+    
+- A byte-level Byte Pair Encoding (BPE) algorithm 
+
+- A simple pre-tokenization rule, no normalization
+
+- A vocabulary size of 250,680
+
+It was trained on a subset of a preliminary version of the corpus using alpha-weighting per language.    
+    
+## Citation
+
+**Cite as:** BigScience, _BigScience Language Open-science Open-access Multilingual (BLOOM) Language Model_. International, May 2021-May 2022
+
+
+
+## Glossary and Calculations
+
+*This section defines common terms and how metrics are calculated.*
 
 -   <a name="loss">**Loss:**</a> A calculation of the difference between what the model has learned and what the data shows ("groundtruth"). The lower the loss, the better. The training process aims to minimize the loss. 
 
@@ -516,13 +476,9 @@ As of 25.May.2022, 15:00 PST:
 
 - <a name="deception">**Deception:**</a> Doing something to intentionally mislead individuals to believe something that is false, such as by creating deadbots or chatbots on social media posing as real people, or generating text documents without making consumers aware that the text is machine generated.
 
-</details>
-<p>&nbsp;</p>
 
 ## More Information
 
-<details>
-<summary>Click to expand</summary><br/>
     
 ### Dataset Creation
 
@@ -548,11 +504,13 @@ Details on the obstacles overcome during the preparation on the engineering side
 
 Initial prompting experiments using interim checkpoints: https://huggingface.co/spaces/bigscience/bloom-book
 
-</details>
-<p>&nbsp;</p>
+
     
 ## Model Card Authors
 *Ordered roughly chronologically and by amount of time spent.*
 
 Margaret Mitchell, Giada Pistilli, Yacine Jernite, Ezinwanne Ozoani, Marissa Gerchick, Nazneen Rajani, Sasha Luccioni, Irene Solaiman, Maraim Masoud, Somaieh Nikpoor, Carlos Muñoz Ferrandis, Stas Bekman, Christopher Akiki, Danish Contractor, David Lansky, Angelina McMillan-Major, Tristan Thrush, Suzana Ilić, Gérard Dupont, Shayne Longpre, Manan Dey, Stella Biderman, Douwe Kiela, Emi Baylor, Teven Le Scao, Aaron Gokaslan, Julien Launay, Niklas Muennighoff
 
+## Model Card Contact
+
+**Send Questions to:** bigscience-contact@googlegroups.com