Skip to main content

TRG 2.03 - Repo structure

StatusCreatedPost-History
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
CODE_OF_CONDUCT.md
CONTRIBUTING.md
DEPENDENCIES
LICENSE
NOTICE.md
README.md
SECURITY.md

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. SeeTRG 1.02 - INSTALL.md.

For the following files, see TRG 7.01

  • AUTHORS.md (optional)
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • DEPENDENCIES
  • LICENSE
  • NOTICE.md
  • SECURITY.md