Why is there a discrepancy in ShopifyQL descriptions for API reports?

[torano]

https://shopify.dev/docs/api/admin-rest/2024-01/resources/report#resource-object

https://shopify.dev/docs/api/shopifyql/shopifyql-reference

Why is there a difference between the shopifyQL description in the shopify reports rest api documentation and the format described in the shopifyQL reference?
How do I get the correct information from the reports using shopifyQL?