sensu / sensu-docs

Sensu documentation
https://docs.sensu.io
MIT License
41 stars 56 forks source link

Correction needed in agent.md to reflect correct docs version #4186

Closed jhenderson-pro closed 1 year ago

jhenderson-pro commented 1 year ago

Description

When running yarn to update docset to version 6.10, I found an issue with a version in the agent.md file. It appears to impact versions 6.7 and 6.8

Category

This is an issue with:

Affected pages

/sensu-go/6.8/observability-pipeline/observe-schedule/agent.md
/sensu-go/6.7/observability-pipeline/observe-schedule/agent.md

Expected behavior

When you select docs version 6.7 or 6.8, you should be able to go to the agent reference menu item.

Current behavior

Currently, if you go to the docs, click on Go to the latest docs version then, on the left, click Observability Pipeline, then Schedule, then Agent reference, everything looks good, it says 6.9 (latest) in the upper right, but the URL is pointing to version 6.6:

https://docs.sensu.io/sensu-go/6.6/observability-pipeline/observe-schedule/agent/

If you click version 6.6 in the upper left, it stays at 6.9 (latest) but still shows the 6.6 URL. Click 6.7 or 6.8, and the Agent reference disappears.

Here is the error that gave me the breadcrumbs and realization we have an issue to resolve:

Running "concurrent:target" (concurrent) task
    Running "hugo-server" task
    { args: [] }
    Running Hugo server
    Running "watch" task
    Waiting...
    Start building sites …
    hugo v0.101.0-466fa43c16709b4483689930a4f9ac8add5c9f66 darwin/amd64 BuildDate=2022-06-16T07:09:16Z VendorInfo=gohugoio
    WARN 2023/04/20 13:54:43 "/Users/jhenderson/sensu-docs/content/sensu-go/6.7/observability-pipeline/observe-schedule/agent.md:1:1": duplicate menu entry with identifier "Agent Reference" in menu "sensu-go-6.9"
    WARN 2023/04/20 13:54:43 "/Users/jhenderson/sensu-docs/content/sensu-go/6.8/observability-pipeline/observe-schedule/agent.md:1:1": duplicate menu entry with identifier "Agent Reference" in menu "sensu-go-6.9"
    WARN 2023/04/20 13:54:43 "/Users/jhenderson/sensu-docs/content/sensu-go/6.9/observability-pipeline/observe-schedule/agent.md:1:1": duplicate menu entry with identifier "Agent Reference" in menu "sensu-go-6.9"

Corrections needed

correct the agents.md file for versions 6.7, 6.8, and 6.9 to reflect what we should be showing.

Screenshots

image

Additional context