Maintain consistent and accurate reference practices throughout project documentation to enhance usability and maintainability. This includes:

  1. Verify link accuracy: Ensure all document cross-references point to the correct filenames and paths. Double-check file extensions and names before submitting changes.

  2. Follow consistent linking conventions: When referencing work in changelogs and release notes:
  3. Avoid redundancy: Instead of duplicating information across multiple documentation files, reference a single source of truth:
## Compatibility
For detailed compatibility information, see the [Migration Guide](https://example.org/docs/migration/).

Rather than:

## Compatibility
- Version 1.6.2 is compatible with Tool X version 1.5.x
- Version 1.7.0 is compatible with Tool X version 1.6.x

Following these standards reduces maintenance burden and ensures that users can consistently find the most current and accurate information.