How this portal is structured, and a suggested workflow for finding your way around it.
This documentation follows a hierarchical structure to help you navigate the 5G-MAG ecosystem efficiently. Reference Tools and Testbeds each have their own project list; every project follows the same set of subcategories covering specifications and roadmap, source code and releases, and hands-on tutorials. Applications is organised differently: it collects end-to-end scenarios assembled from several Reference Tools, grouped by use case rather than by project.
Each Reference Tools and Testbeds project shares a consistent set of subcategories: Scope, Resources, and Tutorials. Not every subcategory has content for every project: a missing item (for example, no packages listed under Resources) means "nothing published yet for this project", not a broken page.
Each project opens on a landing page with a short description, a "Developer Exchange" section of recorded talks and demos where available (labelled "In Action"), and a row of buttons linking to its subcategories (Scope, Resources, Tutorials, and, where available, Developer Exchange). The subcategories below describe what each of these covers.
For acronyms and recurring terms used across the portal, see the Glossary.
Subcategories
Scope
The Scope section outlines the high-level architecture, objectives and specifications of each project, and points to its roadmap. Here, you will find:
- What the project implements, under a "What This Project Implements" heading. Where a project audits itself feature by feature against the specifications, that audit appears as a status board: a card per component showing how much is implemented, then one collapsible section per specification. The specification list itself is not repeated here; it lives on the project's own page at
/standards/<project>, linked from Related. - Architectural diagrams illustrating the implementation.
- A feature matrix mapping specifications to their current implementation status.
- Guidance for identifying which technical standards to study for a deeper understanding.
- A Roadmap heading near the end of the page, linking to the GitHub project board(s) that track the project's planned, in-progress, and completed work. Major features are also tracked via the Reference Tools Roadmaps board; the Roadmap section on the Community page brings these boards together in one place.
Resources
The Resources section provides direct links to the project's GitHub repositories, pre-built packages when available (binaries, containers, Docker deployments), and the latest published releases for each repository, with dates. Each repository includes its own build and installation instructions, as well as links to its issue tracker. The releases listed draw on the same data as the Releases section on the Community page.
Tutorials
The Tutorials section offers end-to-end setup guides. These walkthroughs typically demonstrate how to integrate multiple components to create a functional system. While some tutorials focus on single components, others provide cross-references to related technical topics. Where a project has one, a Developer Exchange subsection collects related community demos and discussion.
Developer Exchange
Where available, a Developer Exchange section on the project's landing page (labelled "In Action") collects recorded talks, demonstrations and workshop sessions related to the project. The full cross-project collection lives at Developer Exchanges.
Suggested Workflow
First, decide how you want to enter the documentation: if you want to understand or run a specific tool, start from Reference Tools; if you want to see what can be built end-to-end from several tools, start from Applications.
Then, to get the most out of a project's documentation, we recommend the following approach:
- Explore the Architecture: Start with the Scope subcategory to understand the high-level design of your chosen technology.
- Assess Status: Check the Roadmap heading within Scope to see what is currently implemented and what is planned.
- Access the Code: Navigate to the Resources subcategory to clone or download the software.
- Implementation: Follow the Tutorials, including any Developer Exchange links, to begin your local setup and testing.
Feedback & Support
We encourage all users to consult this documentation thoroughly before reaching out to maintainers. If your questions remain unanswered, we are happy to assist through our community channels:
- GitHub: For bug reports and feature requests.
- Slack: For real-time community discussion.
- Public Monthly Call: Join our monthly sync to stay updated.