Documentation should go in:

• https://developer.matomo.org/guides/archiving
• https://developer.matomo.org/guides/archiving-behavior-specification
• https://developer.matomo.org/guides/migrate-matomo-4-to-5

This documentation must mark the API as experimental/unstable as it is not currently exposed as @api