The APM documentation relies too heavily on current
. This has created a number of issues, including bad internal and external links when pages move, or docs that cross-link to incorrect versions. As an example, the 6.3 APM Server Overview documentation links to the current versions of both the Node.js and Python agents, even though they are not compatible.
The temporary fix to this solution was to set up shared attributes in the docs repo for older versions of documentation:
shared/attributes.asciidoc
:
:apm-server-ref: https://www.elastic.co/guide/en/apm/server/{branch}
:apm-server-ref-62: https://www.elastic.co/guide/en/apm/server/6.2
:apm-server-ref-64: https://www.elastic.co/guide/en/apm/server/6.4
:apm-py-ref: https://www.elastic.co/guide/en/apm/agent/python/current
:apm-py-ref-3x: https://www.elastic.co/guide/en/apm/agent/python/3.x