add citing.md to toc, modify and format the page a bit

docs/citing.md

@@ -1,5 +1,4 @@
-Citing a Dandiset
------------------
+# Citing a Dandiset
 
 If you use a Dandiset in your research, please acknowledge the Dandiset by citing it, just as you would a publication,
 including the DOI.
@@ -12,21 +11,19 @@ to the citation style required by the journal you are submitting to.
 replace the need to cite the Dandiset itself.**
 
 Citing the Dandiset and other datasets is important because it provides a direct link to the data used in your research. That is crucial, because it:
+
   - allows others to better understand and verify your results, and facilitates reproducibility, 
   - connects your work to other research using the same dataset,
   - provides credit to the data collectors and maintainers, 
   - helps track the impact of DANDI and other data archives.
 
+## Data availability statement
 
-Data availability statements
-----------------------------
 It is common for journals to require a Data Availability Statement in the manuscript, which should include the
 DANDI Archive RRID and the DOI of the Dandiset used in the research.
 Here is an example of a well formatted Data Availability Statement:
 
-```
-The data that support the findings of this study are openly available on the DANDI Archive (RRID:SCR_017571) at [DOI of Dandiset].
-```
+> The data that support the findings of this study are openly available on the DANDI Archive (RRID:SCR_017571) at [DOI of Dandiset] (citation of Dandiset).
 
 **It is important to note that a Data Availability Statement does not replace the need for a full citation in the
 manuscript's references section.**

mkdocs.yml

@@ -32,6 +32,7 @@ nav:
     - Validation Levels for NWB Files: "135_validation.md"
     - Dandiset Metadata: "136_metadata.md"
     - Publishing Dandisets: "14_publish.md"
+    - Citing a Dandiset: "citing.md"
     - Debugging: "15_debugging.md"
     - DANDI CLI and Python API: https://dandi.readthedocs.io
   - Developer Guide: