Improve Navigation Between Services and Documentation

[DenicaGo]

Description

Context: The onboarding process for new implementers has proven to be challenging so user research was done with early implementers to address any obstacles by identifying and analysing areas for improvement within the onboarding experience.

Research finding: We saw there was some difficulty for participants navigating between services and documentation. They relied on external bookmarks or for some they didn’t know the other tools and documents existed. Improving the navigation between services and different sections of the documentation can create a more cohesive flow and reduce friction.

User story: As a user, I want to navigate easily between related sections of the documentation and services, so I can find the information I need without unnecessary effort.

Acceptance Criteria

• All documentation and tool interfaces include clear, consistent navigation to related resources across different sites.
• Each page provides direct links to relevant tools, documentation sections, and services to prevent dead ends.
• A centralized navigation menu or hub allows users to see and access all available tools and documentation in one place.
• Cross-site navigation is seamless, with persistent headers, footers, or contextual links guiding users between resources.
• Each tool or service includes a clear links directing users to the appropriate supporting materials or referenced tools.

If feasible:

• A search function spans multiple sites, enabling users to find relevant content across documentation and tools without needing to search separately.

Impacted sections

UNTP Spec:
GitHub repo - https://github.com/uncefact/spec-untp
Website - https://uncefact.github.io/spec-untp/
https://jargon.sh/user/unece/untp-core/v/0.5.0/artefacts/readme/render
Reference Implementation/Testing:
GitHub repo - https://github.com/uncefact/tests-untp
Website - https://uncefact.github.io/tests-untp/
Demo Instance - https://untp.showthething.com/
Playground - https://test.uncefact.org/untp-playground

Related tickets:

Create a resource hub #281