@unikitty37 opened this Issue on February 3rd 2021

The document at https://matomo.org/docs/event-tracking/ states "If you have Matomo Tag Manager installed, it is the easiest way to implement event tracking on your site." Underneath it, there is a set of instructions, the first of which is "Set up and configure Matomo Tag Manager (create a container and install the container code)" which is linked to https://matomo.org/free-tag-manager/#how-can-i-set-up-matomo-tag-manager-on-my-website.

Expected Behaviour

The documentation contains both a link to the installation instructions for on-premise Matomo, and a link to the instructions for Matomo-as-a-service.

When I click the self-hosted link, I am given instructions on how to create a container running the tag manager and install it on a self-hosted Matomo instance.

Actual Behaviour

There is only the one link. When I click it, I am taken to a page which gives me no instructions on how to install the tag manager, and instead tries to get me to sign up for a 21-day free trial of the hosted version. If I click on the "on-premise" link in the "commitment to open source" section, I am still not taken to installation instructions, but to a page which compares on-premise to hosted, presumably with the goal of getting me to say "oh, I'll just pay for hosted instead".

If I do not fall for this trap, and click "Install now", I am taken to a list of instructions which make no mention whatsoever of how to install the tag manager.

So, where are the instructions for setting this up, and why are they not linked to directly from the first page?

Clicking a link labelled "Set up and configure Matomo Tag Manager (create a container and install the container code)" should take you to a page that tells you how to do exactly that, no?

And surely a "commitment to open source" should include not burying the usage instructions below repeated upsells?

@sgiehl commented on February 3rd 2021 Member

Hi @unikitty37
We are constantly trying to keep our documentation up to date. In the last few months we have even completely revised parts of it. It is quite possible that at one or the other place a link was overlooked and not updated correctly. Many thanks for the hint. We will try to adjust the broken links as soon as possible.

I guess the page you are looking for might be this one: https://matomo.org/docs/tag-manager/

@unikitty37 commented on February 3rd 2021

Thanks — I was quite surprised to find out that the container it referred to was nothing to do with Docker, actually 🙂

@tsteur commented on February 4th 2021 Member

@mattab are we maybe putting these issues into our KB project in the future?

@mattab commented on February 4th 2021 Member

@tsteur the bug here is actually a bug in the website that we had several times in the past. it rewrites the links to the wrong URL.
Here is the rendered text:
Screenshot from 2021-02-05 08-13-53
which links to:
https://matomo.org/free-tag-manager/#how-can-i-set-up-matomo-tag-manager-on-my-website

While the original is:
Screenshot from 2021-02-05 08-13-59
linking correctly to https://matomo.org/docs/tag-manager/#how-can-i-set-up-matomo-tag-manager-on-my-website

Powered by GitHub Issue Mirror