openhab / openhab-docs

This repository contains the documentation for openHAB.
https://www.openhab.org/docs/
Other
274 stars 690 forks source link

List of dead internal links on the website #710

Open ghys opened 6 years ago

ghys commented 6 years ago

For reference:

This Gist has a list of links still broken on the website. https://gist.github.com/ghys/9e4db34a3aa6857e7acfcdb7baf80007

Output of linkchecker https://www.openhab.org/ --ignore-url=v2 --ignore-url=zwave --ignore-url=js -o csv (https://wummel.github.io/linkchecker/)

Confectrician commented 6 years ago

Thanks for collecting them.

ThomDietrich commented 6 years ago

https://github.com/openhab/openhab-docs/blob/gh-pages/update-code-checks.sh

Confectrician commented 6 years ago

We could think of running this script later during the jenkins too.

photoszzt commented 6 years ago

There're more links that are broken that's related to java installation:

It's referenced in this page: https://www.openhab.org/docs/installation/linux.html#recommended-additional-setup-steps in meeting the requirement paragraph.

as a package link: http://zulu.org/zuludocs-folder/Content/ZuluInstallationGuide/PrepareZuluPlatform/AttachAzulPackageRepositories.htm

The first manually link: http://zulu.org/zuludocs-folder/Content/ZuluInstallationGuide/InstallingZulu/InstallLinuxUsingZuluZIPFile.htm

set zulu as alternatives: http://zulu.org/zuludocs-folder/Content/ZuluInstallationGuide/SwitchingBetweenJavaAlternatives/SwitchBetweenJavaAlts.htm

Confectrician commented 6 years ago

Since those links are -external- it would be better to add this as a different issue, or even better open a PR for it.

photoszzt commented 6 years ago

@Confectrician I will file a separate issue.

ThomDietrich commented 6 years ago

@Confectrician it would be nice to recreate the results file. Would you mind doing so (manually for now)? Thanks!!

The linkchecker project is finally taken over by the new community and seriously needed updates are roling in. I'm telling you this, because the latest release might not yet be available on PyPI: https://github.com/linkchecker/linkchecker/releases/tag/v9.4.0 https://github.com/linkchecker/linkchecker/issues/4

Confectrician commented 6 years ago

The bash script is only available in the final branch at the moment and writes something in the readme. Wouldn't we have to adapt that fist? Maybe we will produce merge conflicts, when the readme gets improved again (and it doesn't make sense to update a hidden branch readme of course).