Fix erroneous documentation

[jdbaldry]

This section confused the behavior of the docs/reference shortcode and the generic Markdown reference-style link syntax.

Signed-off-by: Jack Baldry [email protected]

[github-actions]

Overall readability score: 60.13 (🔴 -0.01)

File	Readability
index.md	63.76 (🔴 -0.23)

View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File	Readability	FRE	GF	ARI	CLI	DCRS
index.md	63.76	46.88	8.94	11.9	12.24	6.47
	🔴 -0.23	🟢 +0	🟢 +0	🔴 -0.1	🔴 -0.06	🟢 +0

Averages:

	Readability	FRE	GF	ARI	CLI	DCRS
Average	60.13	47.05	9.65	11.77	12.14	7.33
	🔴 -0.01	🟢 +0	🟢 +0	🟢 +0	🟢 +0	🟢 +0

View metric targets

Metric	Range	Ideal score
Flesch Reading Ease	100 (very easy read) to 0 (extremely difficult read)	60
Gunning Fog	6 (very easy read) to 17 (extremely difficult read)	8 or less
Auto. Read. Index	6 (very easy read) to 14 (extremely difficult read)	8 or less
Coleman Liau Index	6 (very easy read) to 17 (extremely difficult read)	8 or less
Dale-Chall Readability	4.9 (very easy read) to 9.9 (extremely difficult read)	6.9 or less

[clayton-cornell]

Is this still contained within the docs/reference shortcode, or outside?