Fix link and other improvements to markdown

A link in the project was 404ing.

Also, improved the markdown so it publishes better on the docs site.

Example:

• Before: https://docs.gitlab.com/charts/charts/registry/index.html#design-choices
• After: