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/+/171b5ac85aead1c2da0fc6b05853e7bb6964c96b/modules/dumps/files/web/html/pageview-complete_index.html
And the gerrit guide is here