Fix for docs links to schemas

[jgadsden]

Summary:

Fix for broken links to the schema files, plus small changes to the docs

Description for the changelog:

fix for docs links to schemas

Declaration:

Thanks for submitting a pull request, please make sure:

• content meets the license for this project
• (N/A) appropriate unit tests have been created and/or modified
• you have considered any changes required for the functional tests
• you have read the contribution guide and agree to the Code of Conduct
• either no AI-generated content has been used in this pull request
• or any use of AI in this pull request has been disclosed below:
  • AI Tools: [e.g. GitHub CoPilot, ChatGPT, JetBrains Junie, etc]
  • LLMs and versions: [e.g. GPT-4.1, Claude Haiku 4.5, Gemini 2.5 Pro, etc]
  • Prompts: [Summarize the key prompts or instructions given to the AI tools]

Other info:

[jgadsden]

ignore the link-check broken links, this PR fixes them