Further clarifying Model Card sections (#1052)

* Further clarifying Model Card sections

* Capitalization consistency change.

* add requested changes

Co-authored-by: Lucain Pouget <[email protected]>

Author: meg-huggingface

src/huggingface_hub/templates/modelcard_template.md

@@ -13,10 +13,10 @@
 3. [Bias, Risks, and Limitations](#bias-risks-and-limitations)
 4. [Training Details](#training-details)
 5. [Evaluation](#evaluation)
-6. [Model Examination](#model-examination)
+6. [Model Examination](#model-examination-optional)
 7. [Environmental Impact](#environmental-impact)
 8. [Technical Specifications](#technical-specifications-optional)
-9. [Citation](#citation)
+9. [Citation](#citation-optional)
 10. [Glossary](#glossary-optional)
 11. [More Information](#more-information-optional)
 12. [Model Card Authors](#model-card-authors-optional)
@@ -33,12 +33,12 @@
 {{ model_description | default("", true) }}
 
 - **Developed by:** {{ developers | default("[More Information Needed]", true)}}
-- **Shared by [Optional]:** {{ shared_by | default("[More Information Needed]", true)}}
+- **Shared by [optional]:** {{ shared_by | default("[More Information Needed]", true)}}
 - **Model type:** {{ model_type | default("[More Information Needed]", true)}}
 - **Language(s) (NLP):** {{ language | default("[More Information Needed]", true)}}
 - **License:** {{ license | default("[More Information Needed]", true)}}
-- **Related Models:** {{ related_models | default("[More Information Needed]", true)}}
-    - **Parent Model:** {{ parent_model | default("[More Information Needed]", true)}}
+- **Related Models [optional]:** {{ related_models | default("[More Information Needed]", true)}}
+    - **Parent Model [optional]:** {{ parent_model | default("[More Information Needed]", true)}}
 - **Resources for more information:** {{ more_resources | default("[More Information Needed]", true)}}
 
 # Uses
@@ -51,7 +51,7 @@
 
 {{ direct_use | default("[More Information Needed]", true)}}
 
-## Downstream Use [Optional]
+## Downstream Use [optional]
 
 <!-- This section is for the model use when fine-tuned for a task, or when plugged into a larger ecosystem/app -->
 
@@ -83,7 +83,7 @@
 
 {{ training_data | default("[More Information Needed]", true)}}
 
-## Training Procedure
+## Training Procedure [optional]
 
 <!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
 
@@ -125,7 +125,9 @@
 
 {{ results | default("[More Information Needed]", true)}}
 
-# Model Examination
+# Model Examination [optional]
+
+<!-- Relevant interpretability work for the model goes here -->
 
 {{ model_examination | default("[More Information Needed]", true)}}
 
@@ -159,7 +161,7 @@ Carbon emissions can be estimated using the [Machine Learning Impact calculator]
 
 {{ software | default("[More Information Needed]", true)}}
 
-# Citation
+# Citation [optional]
 
 <!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->