godarrenw opened a new issue, #4858:
URL: https://github.com/apache/streampipes/issues/4858

   ### Describe the bug
   
   Six documentation links are dead. I checked every http(s) URL in the 
repository's Markdown files with `curl -L` and re-verified each 404 serially 
with a browser user agent, so these are not rate-limiting artefacts.
   
   **streampipes.apache.org pages that moved** — these paths only exist under 
versioned prefixes (`/docs/0.95.1/...` etc.) and 404 at the unversioned path 
the docs use:
   
   | File | Current link | Status | Current page |
   | --- | --- | --- | --- |
   | 
`streampipes-client-go/docs/content/en/docs/getting-started/first-steps.md:47` 
| `/docs/try-installation/` | 404 | `/docs/quick-start-guide/` (200) |
   | `streampipes-client-python/docs/getting-started/first-steps.md:51` | 
`/docs/deploy-docker/` | 404 | `/docs/configure-operate-deployment/` (200) |
   | `installer/compose/README.md:32` | `/docs/user-guide-tour/` | 404 | 
`/docs/user-guide-introduction/` (200) |
   
   **Apache PLC4X moved to an Antora layout** — `/users/...` no longer exists, 
the pages are under `/plc4x/latest/users/...`:
   
   | File | Current link | Status |
   | --- | --- | --- |
   | `.../adapters.plc4x.s7/documentation.md:57` | 
`https://plc4x.apache.org/users/protocols/s7.html` | 404 |
   | `.../adapters.plc4x.generic/documentation.md:75` | same URL | 404 |
   
   `https://plc4x.apache.org/plc4x/latest/users/protocols/s7.html` returns 200. 
These two matter a little more than the rest because they are adapter 
descriptions rendered in the StreamPipes UI, so end users see them.
   
   **apache/sis renamed the file and the default branch**:
   
   `installer/scripts/epsg/Readme.md:95` links 
`.../sis/blob/master/core/sis-referencing/src/main/resources/org/apache/sis/referencing/factory/sql/EPSG_Finish.sql`
 → 404. `apache/sis` now defaults to `main`, and the file is 
`optional/src/org.apache.sis.referencing.epsg/main/org/apache/sis/referencing/factory/sql/epsg/Finish.sql`
 (verified through the GitHub trees API; the name changed from 
`EPSG_Finish.sql` to `Finish.sql`).
   
   ### Expected behavior
   
   The links resolve to the current pages.
   
   ### Additional context
   
   I have the replacements ready and will open a PR referencing this issue. 
Separately, the Go client's `first-steps.md` also documents a `go get` command 
that cannot work (`go get https://...` — `go get` does not accept a URL scheme, 
and the repository root is not a Go module); I'll raise that on its own since 
it is not a link problem.
   
   _Disclosure: prepared with AI assistance; every URL above was verified 
manually._
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to