Proposal - Categories of documents

[TuThoThai]

This is a proposal for us to clarify the names of the types of NeTEx documentation. The aim is to make sure that we agree on the content and purpose of each type. Also, it woud facilitate the dissemination in the future.

Profile: Any techincal documentation of NeTEx that is considered as a subset of NeTEx. Its objective is to facilitate the data exchange between stakeholders.
Example: EPIP, EPIAP, EFIP, Nordic Profile, Dutch Profile, French Profile

Technical guide: Any technical documentation that supports either the modelling of a functional part of NeTEx (e.g., stop places, timetables, fares, etc.), a category of public transport (e.g., alternatives modes of operation, flexible services, long-distance rail, etc.), or the needs of a specific category of stakeholders (e.g., data producers, data consumers, etc.).
Example: How to model multimodal stop places, Long-distance rail in NeTex, Quickstart for software developpers in NAP

General guide: Any non-technical documentation that supports the better understanding of NeTEx and its ecosystem.
Example: Why NeTEx?, NeTEx help guide for regulation authorities, FAQ, Glossary (or Ontology)

[TuThoThai]

Comment from @thbar: this is a good start and could be extended to a Glossary for the entire Transmodel ecosystem that could be a stand-alone source of truth (repository in this organisation)

[TuThoThai]

Comment from @atibaut, other categories of documents should be added:

• Glossary: all the terms and definitions for documents and their related items in the Transmodel Ecosystem. It is not the data dictionnary of Transmodel.
• White paper: a mixed of a technical and non-technical document addressing a specific topic.

[TuThoThai]

Input from both @hfjelstad and @thbar

• Instead of Glossary, we could use the name Ontology or Knowledge graph
• Going further, could be built AI-ready
• Also, addition in the Gklossary definition that is a bird-eye view of documentation, documents, and content produced in the Transmodel Ecosystem

[TuThoThai]

Input from @SaraGuerraOliveira

• White paper could be merged with General guide with the former being the final name

[TuThoThai]

As of 5 May 2026, consensus for the categories of documents with the 3 as a starting point.