It is better placed inside of the macros file, which is why I documented it there as well. However, the API files are the files that will be used to generate documentation in our documentation UI, so I think it's useful to have it in there as well to avoid people having to find it in the list macro.