docs: restructure docs for new hosting

[owenrumney]

Description

This PR restructures the docs a little to support the new hosting in
CloudFlare and breaking away the home page management to marketting
while retaining a workable docs site.

Key changes -

• rename docs/docs to docs/guide as a path
• rename Docs menu to User Guide
• update the index in docs/guide to reflect the new name of User Guide
• remove the assets that were for partner and home page
• remove the partner page from the nav
• update the links to point to guide rather than docs where applicable
• update the mage file to remove the redunant CSS target
• update the links in the the mage docs for specialist references files

Note

Home and Partners is rewritten during the deployment to CloudFlare from the rather empty docs/index.md to the root of the Marketting site

Related issues

• Close docs: restructure the docs for new hosting #9798

Checklist

• I've read the guidelines for contributing to this repository.
• I've followed the conventions in the PR title.

[knqyf263]

We probably need to update mkdocs.yml as Partners is still shown and returns 404.

[owenrumney]

We probably need to update mkdocs.yml as Partners is still shown and returns 404.

Partners is rewritten during the build in trivy-www. https://github.com/aquasecurity/trivy-www/blob/main/build/filter_nav.py#L7-L9

We can remove it entirely from the mkdocs if its not something we need in the actual docs?

If we remove the partners link from the docs, it removes a substantial amount of the preprocessing, so I'm all for it - @itaysk - do you have an opinion on partners link in the Docs area?

[knqyf263]

Home and Partners is rewritten during the deployment to CloudFlare from the rather empty docs/index.md to the root of the Marketting site

Oh, sorry I missed it. It seems more intuitive to keep MkDocs running on its own instead of returning a 404 for partners, and it might also be less confusing for external contributors (and even maintainers like me 😄 ), but I’m fine either way.

[owenrumney]

Home and Partners is rewritten during the deployment to CloudFlare from the rather empty docs/index.md to the root of the Marketting site

Oh, sorry I missed it. It seems more intuitive to keep MkDocs running on its own instead of returning a 404 for partners, and it might also be less confusing for external contributors (and even maintainers like me 😄 ), but I’m fine either way.

Don't worry, you didn't miss it, I added it to make it more clear :-D

I think removing it is probably best for the developer experience - if Itay wants it in the docs, it can be added at the trivy-www level.

I've updated the PR.

[knqyf263]

Personally, I feel that the partner page doesn’t need to be included in the documentation, but since I don’t have a strong opinion about it, let’s hear what Itay thinks.

[nikpivkin]

There are a couple more places where docs is still used:

• trivy/.github/CODEOWNERS

  Lines 11 to 12 in cbad9ca

  	docs/docs/scanner/misconfiguration/ @simar7 @nikpivkin
  	docs/docs/target/aws.md @simar7 @nikpivkin

• trivy/docs/docs/advanced/telemetry.md

  Line 19 in cbad9ca

  --8<-- "./docs/docs/advanced/telemetry-flags.md"