Created attachment 1710389 [details] Sample page with description in <pre> tag In templates DSL documentation (bz#1819150), parts of description are sometimes put in <pre> tag and rendered as code. For one of examples see `/dsldoc/all/Foreman::Renderer::Scope::Macros::Loaders/load_hosts.html`. There is "code" in main description on top, and then in "includes" and "joins" parameters description. See also attached screenshot. In foreman source code, I see these strings are broken into multiple lines (to prevent code editor from wrapping them), and second and later lines are indented. Looks like documentation generator runs these strings through markdown parser, which in turn considers lines indented by more than 4 spaces to be "preformatted". Adding blocks on bz#1819150 to maintain relation between these two, but I wouldn't say this "must" be resolved first.
Created attachment 1713766 [details] Same page - after fix
Unnecessary <pre> tags in description are no longer present. Text is no longer presented as preformatted, it's normal text instead. See "Same page - after fix" attachment. Tested on documentation version available as of September 4, 2020.
Since the problem described in this bug report should be resolved in a recent advisory, it has been closed with a resolution of ERRATA. For information on the advisory (Important: Satellite 6.8 release), and where to find the updated files, follow the link below. If the solution does not work for you, open a new bug report. https://access.redhat.com/errata/RHSA-2020:4366