Update index.md

[JeremyLikness]

Update links to correct paths. Fixes #3639.

[roji]

Looks OK but I think we prefer xref for internal links such as these (/cc @smitpatel)

[JeremyLikness]

Thanks @roji. Am interested in what @smitpatel says because this documentation suggests XREF is for API documentation.

[smitpatel]

xref references pages using their ids. That helps with API mainly so it can reference links from other docset. For pages in same docset - using relative file.md, using relative link path and using xref all works the same. We as a team went to use xref because that causes least number of break whenever we rename something as long as the unique id given to page doesn't change. One of those case where we defer from official docs for ease of maintenance. I frown upon using relative file path as we don't get warning about them being broken in build.

[roji]

I frown upon using relative file path as we don't get warning about them being broken in build.

Yeah, that part seems pretty important.

[JeremyLikness]

I will squash/merge and look at migrating to xref on future revisions.