Improved clarity of the whole footnotes section

doc/user/markdown.md

@@ -773,25 +773,29 @@ do*this*and*do*that*and*another thing
 
 ### Footnotes
 
-Footnotes add a link to a note rendered at the end of a Markdown file:
+Footnotes add a link to a note that  will be rendered at the end of a Markdown file.
+
+To make a footnote, you need both a reference tag and a separate line (anywhere in the file) with the note content.
+
+Regardless of the tag names, the relative order of the reference tags determines the rendered numbering.
 
 ```markdown
-You can add footnotes to your text as follows.[^1]
+A footnote reference tag looks like this:[^1]
 
-[^1]: This is a footnote (later in file).
+[^1]: This is the contents of a footnote.
 
-You can use letters and other characters in the footnote.[^footnote-note]
+Reference tags can use letters and other characters.[^footnote-note]
 
-[^footnote-note]: Footnote numbers are auto-generated by order, so it does not matter what the tag name is.
+[^footnote-note]: Unfortunately, an upstream bug causes rendering failure for tags that include lowercase 'w' (see issue #24423).
 ```
 
-You can add footnotes to your text as follows.[^1]
+A footnote reference tag looks like this:[^1]
 
-[^1]: This is a footnote (later in file).
+[^1]: This is the contents of a footnote.
 
-You can use letters and other characters in the footnote.[^footnote-note]
+Reference tags can use letters and other characters.[^footnote-note]
 
-[^footnote-note]: Footnote numbers are auto-generated by order, so it does not matter what the tag name is.
+[^footnote-note]: Unfortunately, an upstream bug causes rendering failure for tags that include lowercase 'w' (see issue #24423).
 
 ### Headers