hashicorp / consul

Consul is a distributed, highly available, and data center aware solution to connect and configure applications across dynamic, distributed infrastructure.
https://www.consul.io
Other
28.41k stars 4.43k forks source link

Developer Site Docs for "service-to-service-traffic-datacenters" for Mesh Gateways is a Dead End #17172

Open reskin89 opened 1 year ago

reskin89 commented 1 year ago

Overview of the Issue

The Invoke Services From Lambda Functions document has a link to Mesh Gateways between Datacenters under "Deploying Mesh Gateways".

The link provided leads to a page that just shows:

{}

Reproduction Steps

Log Fragments

The browser console is showing a 404 for that page.

jkirschner-hashicorp commented 1 year ago

@reskin89 : In summary, the page you're looking for is here. The root cause of the broken link seems to be because of how our versioned documentation pages currently work... I'll follow up on that.

Details

It appears that all the links on the v1.13.x version of the "invoke services from lambda functions" page (that you linked to) point to the "latest" (1.15.x) docs rather than the same version you're currently viewing (1.13.x).

The page you're looking for is: https://developer.hashicorp.com/consul/docs/v1.13.x/connect/gateways/mesh-gateway/service-to-service-traffic-datacenters

If "v1.13.x/" is removed from that URL, it fails because the page was recently renamed to be "wan-datacenters" instead of just "datacenters" at the end: https://developer.hashicorp.com/consul/docs/connect/gateways/mesh-gateway/service-to-service-traffic-wan-datacenters

I would expect versioned docs pages to point to other docs on the same version, rather than point to a different version (latest). I'll ask about this.

reskin89 commented 1 year ago

Thank you!

jkirschner-hashicorp commented 1 year ago

The plot thickens...

It seems that versioned docs pages generally behave as you'd expect: they point to docs links for the same version.

For some reason, that isn't happening on the specific page you linked to... but I don't know why yet.