So, the goal is to keep an historic archive of pageview activity, right?
Correct
And I can imagine the «pageview» has been designed to be suitable for data
processing (API's, etc). Isn't it?
Yes, more for automated parsing/compute than for human readability.
And if you're looking to help improve the documentation, then we very much
welcome that, and I can point you in the right direction as well.
I would really like to be able to do it.
The code is here: https://gerrit.wikimedia.org/g/operations/puppet/+/171b5ac85aead1c2da0fc6b05... And the gerrit guide is here https://www.mediawiki.org/wiki/Gerrit.