How can we improve our documentation?

@puneetse @william.douglas @tvb

crosspost of Clear Linux Project has a new documentation site - #2 by mek in suggestion of @Businux

Looks like this info is quite outdated but also still I stumble over old links which do not work anymore.

for example, if I look at:

It still has an old link:
https://docs.01.org/clearlinux/latest/guides/clear/mixer.html

which has a 304 to:
https://corpredirect.intel.com/Redirector/404Redirector.aspx?404;https://docs.01.org/clearlinux/latest/guides/clear/mixer.html

which hits:
https://www.clearlinux.org/clear-linux-documentation/latest/guides/clear/mixer.html
which does not exits.

Is it possible to strip or redirect the /latest (and maybe other ones similar if exist) on the webserver
Usually the ones without /latest work, like here:
https://www.clearlinux.org/clear-linux-documentation/guides/clear/mixer.html

Maybe not so easy, but looking at the web server logs of docs.01.org / corpredirect.intel.com / www.clearlinux.org could show from where redirects come and which pages fail.

And till then if one hits a 404 documentation link with a /latest as part of the URI
stripping that seems to help. :wink:

1 Like