Skip to main content

TRG 2.03 - Repo structure

StatusCreatedPost-History
Update22-Dec-2025Remove redundancy to TRG 7-01
Active06-Dec-2023reword Why section + highlight optional files
25-Nov-2022adjustments to DEPENDENCY, LICENSE, NOTICE
24-Nov-2022add FOSS/Eclipse related basic files
10-Nov-2022Initial release

Why

In order to foster consistency, collaboration and ease of navigation, adhereing to a specific repository structure is important. The structure serves a standardized framework, facilitating efficient development by providing a clear organisation of essential project components. By adopting recommended layout of files and directories, contributors can quickly locate resources such as source code, documentation and configuration files. Moreover specified repository structure aligns with industry best practices.

Description

All repositories MUST contain the following files and folders:

/docs
/charts
README.md
<<other mandatory files from TRG 7.01>>

All repositories MUST contain files required due to legal needs as defined in TRG 7.01

Recommended but optional:

AUTHORS.md
INSTALL.md

Directories

/docs

The /docs directory MUST contain detailed product related documentation for the Tractus-X product. Folder structure inside this directory is the responsibility of the repository owner/product team.

/charts

The /charts directory MUST contain the Helm chart for the Tractus-X product IF available. For more information about Helm Chart structure, refer to TRG 5.01 - Helm Chart requirements.

Files

README.md

Your repository MUST contain a README.md file. See TRG 1.01 - README.md.

INSTALL.md

Your repository SHOULD contain a INSTALL.md file. See TRG 1.02 - INSTALL.md.