Description of problem:
The deployed documentation links to menu.css and print.css files that exist, in addition to those that do. I believe this is because publican allows you to deploy styles at both the site and brand level. We are currently only using one of these, under the common folder.
We should look into whether we can strip the errant directives linking to these files that currently result in 404s.
<awels> Good afternoon/evening depending on which timezone you are in.
<awels> I am the new RHEV UI developer. I am working on the symlink/documentation in different locales issue
<steveg> lucky you ;)
<awels> its pretty straight forward, but while working on it I noticed references to non existing style sheets in the documentation
<steveg> which ones?
<awels> <link href="../../../menu.css" type="text/css" rel="stylesheet">
<awels> <link media="print" href="../../../print.css" type="text/css" rel="stylesheet">
<awels> those basically resolve to the root of the docs tree
<awels> and there are no style sheets in there.
<awels> Also there is a menu.css defined here as well
<awels> <link href="../../../common/en-US/css/menu.css" type="text/css" rel="stylesheet">
<steveg> they are part of publican's fallback system for styles
<awels> so I don't know if those are extra or no longer needed but never removed.
<awels> Right now we just return a 404, since they don't exist.
<steveg> at the moment they are surplus, so i could technically drop them
<steveg> but we are trying to minimize the amount of interference we do with the HTML
<steveg> as it's the same HTML deployed to access.redhat.com
<steveg> i believe the reason they include both menu.css links (for example) is that you can have styles at both the site and brand (package) level
<awels> Well I just noticed the missing files, and I wasn't sure if those were links that should point to an actual file or if they were dead links.
<awels> Just wanted to make you aware, that is all.
<steveg> i will raise a bug to see if we can clean it up but in this deployment scenario i would say they are intentionally dead
<awels> Okay, I will stop worrying about it then, and just return the 404 as expected.
<steveg> yeah, im raising a bug against the rhevm-doc package to follow up