WTH Unavailable documentation pages (404)

It seems like during recent year some docs pages have been moved to new addreses.
There are a lot of google indexed pages and forum posts (created not more than a year ago) which refers to not existing docs pages.
Really? is it so hard to make 301 redirs to new ones?
So many usefull pages on forum which points to nowhere.

The documentation is run by humans (unfortunately). They have the capacity to forget to update pages!

Having said that, it’s also not hard for community members to raise an Issue on GitHub or click the “edit” button to contribute fixes to the documentation…

you missed the point. I’m not talking about references found in docs but about urls found outside documentation.

Nobody will update written in the past forum posts or other articles found in internet just because devs decided to migrate docs to new addresses. It’s out of anyones abilities.
Mistake was to migrate docs not ensuring automatic redirection to new locations. Basic thing to do.

Here is example: post created in December’19: SSH to the host (HassOS)

Ok, your link redirects to the forum, which still works. But the first link on that post gives

image

Missed the focus on this tidbit

That page has moved here: Debugging the Home Assistant Operating System | Home Assistant Developer Docs

Feel free to raise an issue in the home-assistant.io repository to get a redirection added. That’s what open source is all about. The more people that help the better it becomes.

There’s 400,000 posts a year and ~20 moderators. If we were in full force (all 20) and looking at 55 posts a day, it would take us a full year (not including the previous years posts) to go through all these. There’s no magical tool or bot that does this. This isn’t happening.

You’re more than welcome to flag posts and we’ll update the link (if we can).

1 Like