webadmin: remove asciidoctor errors and html syntax issues

[JasperB-TeamBlue]

Bug fix

Fixes issue #3000

Changes proposed in this pull request:

• removed rest-api docs due to it now being hosted on it's own github pages
• updated headers on files where parameters were not filled in.
• downgraded leveloffset on certain files to disable too deep of an offset

I confirm that this pull request was submitted according to the contribution guidelines:
@JasperB-TeamBlue

This pull request needs review by:
@sandrobonazzola @dupondje @peter-boden

[sandrobonazzola]

Dropping {URL_virt_product_docs}{URL_format} is likely going to break Oracle documentation based on oVirt docs.
I guess RHV doc is not built from here anymore but just to be sure, let me ask. @oVirt/ovirt-documentation anybody still around?

[dupondje]

@duck-rh :

ovirt-site/Dockerfile

Line 2 in ea4a991

FROM registry.fedoraproject.org/fedora:33

I guess the production builder does run something more recent? :)

[peter-boden]

1 remark.

Also one question: what makes it that the absolute path is a problem in these files an not in other spots? (there are a lot more usages of this URL_virt_product_docs var)

[JasperB-TeamBlue]

1 remark.

Also one question: what makes it that the absolute path is a problem in these files an not in other spots? (there are a lot more usages of this URL_virt_product_docs var)

In some places this seemed to not be filled in on the local html files but it were functional links on the development server. This fix makes the links relative which removes this issue and improves the surfing experience. All other links could be replaced but were in my opinion not part of the scope for this PR.

[dupondje]

1 remark.
Also one question: what makes it that the absolute path is a problem in these files an not in other spots? (there are a lot more usages of this URL_virt_product_docs var)

In some places this seemed to not be filled in on the local html files but it were functional links on the development server. This fix makes the links relative which removes this issue and improves the surfing experience. All other links could be replaced but were in my opinion not part of the scope for this PR.

Can't we figure out the cause of this and fix that instead of working around it?
And can you also rebase the PR ? :)

[JasperB-TeamBlue]

1 remark.
Also one question: what makes it that the absolute path is a problem in these files an not in other spots? (there are a lot more usages of this URL_virt_product_docs var)

In some places this seemed to not be filled in on the local html files but it were functional links on the development server. This fix makes the links relative which removes this issue and improves the surfing experience. All other links could be replaced but were in my opinion not part of the scope for this PR.

Can't we figure out the cause of this and fix that instead of working around it? And can you also rebase the PR ? :)

The cause seemed to be that the affected files were missing some vital headers that were needed to fill in parameters.