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
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)