Frontend: CI Catalog initial feedback: URL nested under namespace is confusing

Background

While reviewing the first component project in the CI Catalog for gitlab-org I've noticed a few problems with the UX, reported below.

URL nested under namespace is confusing

Example: https://gitlab.com/gitlab-org/quality/pipeline-common/-/ci/catalog/resources is not the catalog for a given project but the catalog for the top-level namespace gitlab-org. The same resources are visible to all projects.

A URL from another project shows (correctly) the same resources https://gitlab.com/gitlab-org/gitlab/-/ci/catalog/resources.

A URL should be a unique identifier for a web source but nesting it under projects makes it confusing for users

Expectation: SSoT URL for the whole namespace https://gitlab.com/gitlab-org/-/ci/catalog/resources

Other notes

The breadcrumb stops to the CI/CD Catalog and the link is inconsistent

See details here

When I navigate into a catalog resource page, the breadcrumb stops to the CI/CD catalog:

The expectation is that it would show ... > CI/CD catalog > [name of the project]

• When on the catalog resource page, the link CI/CD Catalog from the breadcrumbs points to the same catalog resource page
• When on the catalog index page, the link CI/CD Catalog from the breadcrumbs points to the same catalog index page

The link is not consistent.

• See the issue here 👉 #421922 (closed)

Mermaid diagrams and perhaps syntax highlighting not rendered

See details here

See https://gitlab.com/gitlab-org/quality/pipeline-common/-/ci/catalog/resources/27#key

• See the issue here 👉 #421923

Relative links from README are broken

See details here

Example: click on the `README.md` link in https://gitlab.com/gitlab-org/quality/pipeline-common/-/ci/catalog/resources/27#live-environment-pipelines

• See the issue here 👉 #421926 (closed)