A few Issues on page /docs/04-metadata.html

[jccaicedo]

The first paragraph mentions Figure 3:

• Can we add a link to the figure?
• Are we sure the text refers to Figure 3 or Figure 2.
• This chapter shows Figure 2 and another figure without caption. Can we add a caption and assign a number to the second figure?

In the paragraph before Figure 2, there is a link to Section 3. This link is incorrect and should now point to Section 5.

[rsenft1]

We can solve both the first and second bullet using this notation to refer to figures: {numref}figure-name where figure-name is the name field in the figure (it actually is also wrapped in backticks). In this example, it would be index-file.

```{figure} images/image4.png
---
name: index-file
---
Screenshot of an example index.csv file

I've started doing this for figures on this page and we can also do it for other pages to make referencing consistent (and it will also update the name if we add a figure)

I also added a caption for the second figure and the link should be fixed. Tentatively, I believe everything here has been addressed

[Arkkienkeli]

I have renamed index.csv or "index" across all the documentation (except command examples) to "metadata".
index.csv is a default name, but user can specify other name of metadata file.

[jccaicedo]

Thank you @rsenft1 !
@Arkkienkeli is there anything missing in this issue? If not, feel free to close it.

[Arkkienkeli]

@jccaicedo
I think we should describe single-cell metadata in this section.

[rsenft1]

@Arkkienkeli , could you explain more what you mean by single-cell metadata? We do have a description of the single cell locations. Is there something else we should describe?