Re: [ovirt-devel] [rhevm-staff] oVirt website hackathon

Hi, So I've found linkchecker[1], which is quite a powerful and useful tool for that, and run it on oVirt.org, the results are not good, unfortunately. We have over 15K(!) of broken links to fix before we can even consider adding a constant CI job to check new commits. Snippet example from the huge report attached to this email [2]. ( btw there are other formats available to generate this report if we want )

After we'll do an initial cleanup of the broken links ( similar to what we did on findbugs errors ), we can consider adding CI for it, 2 ideas I had in mind: 1. Running the tool on GitHub PR using Travis CI ( which ovirt-site is already connected to it ), the tool seems to be using it as well for testing itself 2. Adding ovirt-site as a std-ci project and using it to also properly deploy to the site in the end ( more complex and long term goal, which might require more work ). TL;DR, let's schedule a doc-fix day first to address the sheer amount of broken links and then worry about adding CI. [1] https://github.com/wummel/linkchecker [2] URL `develop/release-management/features/sla/hosted-engine- agent-offloading/#documentation' Name `Documentation/External references' Parent URL https://ovirt.org/develop/release-management/features/ sla/hosted-engine-agent-offloading/, line 1870, col 131 (HTML <http://validator.w3.org/check?ss=1&uri=https://ovirt.org/develop/rele...>) (CSS <http://jigsaw.w3.org/css-validator/validator?uri=https://ovirt.org/develo... ) Real URL https://ovirt.org/develop/release-management/features/ sla/hosted-engine-agent-offloading/develop/release- management/features/sla/hosted-engine-agent-offloading/#documentation Size 14.63KB Check time 3.496 seconds Result Error: 404 Not Found URL `/images/apple-touch-icon-precomposed.png' Parent URL https://www.ovirt.org, line 22, col 1 (HTML <http://validator.w3.org/check?ss=1&uri=https://www.ovirt.org>) (CSS <http://jigsaw.w3.org/css-validator/validator?uri=https://www.ovirt.org&am... ) Real URL https://www.ovirt.org/images/apple-touch-icon-precomposed.png Size 14.63KB Check time 1.851 seconds Result Error: 404 Not Found