[DOC] Fix broken links in earlier versions of the docs

[hdhalter]

What do you want to do?

• [ ] Request a change to existing documentation
• [ ] Add new documentation
• [x] Report a technical problem with the documentation
• [ ] Other

Tell us about your request. Provide a summary of the request and all versions that are affected. There are a number of broken links in the archived documentation. When we need to backport to previous versions, we get build errors.

What other resources are available? Provide links to related issues, POCs, steps for testing, etc. Starting from 2.3, there are 49 broken links. We need to fix these and backport to 2.0. There will be additional broken links in 2.2-2.0, but fixing these 49 will get the majority.

Found 49 dead links: (RuntimeError)

• [ ] #lucene-version-reference, linked in ./_install-and-configure/upgrade-opensearch/index.md
• [ ] #range-query, linked in ./_opensearch/supported-field-types/range.md
• [ ] #create-reports-using-a-definition, linked in ./_dashboards/reporting.md
• [ ] #windows-usage, linked in ./_security/configuration/security-admin.md
• [ ] #use-a-helm-chartuse-a-helm, linked in ./_tools/k8s-operator.md
• [ ] https://opensearch.org/docs/latest/dashboards/reporting#create-reports-using-a-definition, linked to in ./_observing-your-data/notebooks.md
• [ ] https://opensearch.org/docs/latest/api-reference/cluster-settings/, linked to in ./_opensearch/configuration.md
• [ ] https://opensearch.org/docs/latest/clients/opensearch-py-ml/, linked to in ./_clients/index.md
• [ ] https://opensearch.org/docs/latest/opensearch/supported-field-types/xy/, linked to in ./_dashboards/visualize/viz-index.md
• [ ] https://opensearch.org/docs/latest/dashboards/admin-ui-index/sm-dashboards#view-edit-or-delete-an-sm-policy, linked to in ./_tuning-your-cluster/availability-and-recovery/snapshots/snapshot-management.md
• [ ] https://opensearch.org/docs/latest/query-dsl/, linked to in ./404.md
• [ ] https://opensearch.org/docs/latest/dashboards/selfhost-maps-server/, linked to in ./_dashboards/visualize/geojson-regionmaps.md
• [ ] https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/opensearch/#amazon-opensearch-service-domain-security, linked to in ./_data-prepper/pipelines/configuration/processors/otel-trace-group.md
• [ ] https://opensearch.org/docs/latest/opensearch/install/index/, linked to in ./_tools/logstash/ship-to-opensearch.md
• [ ] https://opensearch.org/docs/latest/opensearch/supported-field-types/xy-point, linked to in ./_opensearch/query-dsl/geo-and-xy/index.md
• [ ] https://opensearch.org/docs/latest/neural-search-plugin/index/, linked to in ./_install-and-configure/plugins.md
• [ ] https://opensearch.org/docs/latest/dashboards/index/, linked to in ./_install-and-configure/install-dashboards/docker.md, ./_install-and-configure/plugins.md, ./_observing-your-data/log-ingestion.md, ./404.md, ./about.md, ./quickstart.md
• [ ] https://opensearch.org/docs/latest/data-prepper/trace_analytics/#opentelemetry-collector, linked to in ./_data-prepper/common-use-cases/trace-analytics.md
• [ ] https://opensearch.org/docs/latest/security/configuration/multi-auth/, linked to in ./_security/authentication-backends/openid-connect.md, ./_security/authentication-backends/saml.md
• [ ] https://opensearch.org/docs/latest/dashboards/quickstart/, linked to in ./_dashboards/discover/index-discover.md
• [ ] https://opensearch.org/docs/latest/dashboards/maptiles/, linked to in ./_dashboards/visualize/geojson-regionmaps.md
• [ ] https://opensearch.org/docs/latest/dashboards/quickstart-dashboards/, linked to in ./_install-and-configure/upgrade-opensearch/appendix/rolling-upgrade-lab.md
• [ ] https://opensearch.org/docs/latest/data-prepper/configuration/sinks/opensearch/, linked to in ./_data-prepper/common-use-cases/trace-analytics.md discover/index.md, linked to in ./_dashboards/get-started/quickstart-dashboards.md
• [ ] https://opensearch.org/docs/latest/availability-and-recovery/snapshots/snapshot-restore/#shared-file-system, linked to in ./_api-reference/snapshots/create-repository.md
• [ ] https://opensearch.org/docs/latest/security-analytics/index/, linked to in ./_install-and-configure/plugins.md
• [ ] https://opensearch.org/docs/latest/dashboards/visualize/visbuilder/, linked to in ./_dashboards/visualize/viz-index.md
• [ ] https://opensearch.org/docs/latest/opensearch/supported-field-types/xy-shape, linked to in ./_opensearch/query-dsl/geo-and-xy/index.md
• [ ] https://opensearch.org/docs/latest/dashboards/visualize/viz-types/, linked to in ./_dashboards/visualize/area.md
• [ ] https://opensearch.org/docs/latest/security-plugin/configuration/security-admin/#a-word-of-caution, linked to in ./_install-and-configure/upgrade-opensearch/index.md, ./_tuning-your-cluster/availability-and-recovery/snapshots/snapshot-restore.md
• [ ] https://opensearch.org/docs/latest/opensearch/query-dsl/full-text, linked to in ./_opensearch/query-dsl/term.md, ./_search-plugins/sql/index.md
• [ ] https://opensearch.org/docs/latest/availability-and-recovery/snapshots/snapshot-restore/#amazon-s3, linked to in ./_api-reference/snapshots/create-repository.md
• [ ] https://opensearch.org/docs/latest/dashboards/discover/, linked to in ./_dashboards/get-started/quickstart-dashboards.md
• [ ] https://opensearch.org/docs/latest/install-and-configure/install-dashboards/debian/, linked to in ./_install-and-configure/install-dashboards/index.md
• [ ] https://opensearch.org/docs/latest/opensearch/api-reference/document-apis/bulk/, linked to in ./_dashboards/run-queries.md
• [ ] https://opensearch.org/docs/latest/opensearch/supported-field-types/xy, linked to in ./_opensearch/query-dsl/geo-and-xy/index.md
• [ ] https://opensearch.org/docs/latest/dashboards/install/plugins/, linked to in ./_observing-your-data/trace/ta-dashboards.md
• [ ] https://opensearch.org/docs/latest/data-prepper/configuration/processors/otel-trace-raw/, linked to in ./_data-prepper/common-use-cases/trace-analytics.md
• [ ] https://opensearch.org/docs/latest/dashboards/get-started/time-filter/, linked to in ./_dashboards/get-started/quickstart-dashboards.md
• [ ] https://opensearch.org/docs/latest/security/multi-tenancy/tenant-index/, linked to in ./_security/index.md, ./_observing-your-data/notebooks.md
• [ ] https://opensearch.org/docs/latest/data-prepper/peer_forwarder/, linked to in ./_data-prepper/common-use-cases/trace-analytics.md time-filter.md, linked to in ./_dashboards/get-started/quickstart-dashboards.md
• [ ] https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/opensearch/#opensearch-cluster-security, linked to in ./_data-prepper/pipelines/configuration/processors/otel-trace-group.md
• [ ] https://opensearch.org/docs/latest/dashboards/install/index/, linked to in ./_tools/logstash/ship-to-opensearch.md
• [ ] https://opensearch.org/docs/latest/opensearch/query-dsl/geo-and-xy/xy, linked to in ./_opensearch/query-dsl/geo-and-xy/index.md
• [ ] https://opensearch.org/docs/latest/dashboards/dashboard/, linked to in ./_dashboards/get-started/quickstart-dashboards.md
• [ ] https://opensearch.org/docs/latest/security/multi-tenancy/tenant-index, linked to in ./_security/configuration/yaml.md
• [ ] https://opensearch.org/docs/latest/opensearch/query-dsl/full-text/#multi-match, linked to in ./_search-plugins/sql/full-text.md
• [ ] https://opensearch.org/docs/latest/data-prepper/configuration/processors/service-map-stateful/, linked to in ./_data-prepper/common-use-cases/trace-analytics.md

[shubhusion]

Kindly assign this issue to me @hdhalter.

[hdhalter]

Hi @shubhusion - Are you still interested in working on this? Thanks.

[hdhalter]

Done for 2.3.