Improve Initial Setup 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: Several participants mentioned the onboarding process as potentially more burdensome than it needs to be. Documentation can be streamlined by breaking down large sections into digestible chunks, creating a more intuitive flow, especially for first-time users and grouping related topics together to ensure that all necessary introductory material is upfront.

User story: As a new user, I want to follow a clear, concise, and easy-to-understand initial setup guide, so that I can get started quickly without feeling overwhelmed or encountering setup errors.

Acceptance Criteria

• The onboarding guide is structured in small, digestible steps to prevent information overload.
• Each step includes clear instructions, examples, and expected outcomes to reduce ambiguity.
• The most critical setup tasks are presented upfront in a logical, step-by-step sequence.
• Related topics are grouped together to ensure necessary context is provided at the right time.
• Common pitfalls and troubleshooting tips are provided at relevant points in the guide.
• Technical jargon is minimized, and any required terms are defined in context or linked to a glossary.
• The guide is visually structured with headings, bullet points, and callouts to improve readability.
• A quick-start summary or checklist is available for experienced users who want to skip unnecessary details.

Impacted sections

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

Ticket replicated here: uncefact/tests-untp#209