Skip to content

feat: Add architecture documentation in architecture tab and ADRs#271

Draft
matbmoser wants to merge 2 commits intomainfrom
feat/architecture
Draft

feat: Add architecture documentation in architecture tab and ADRs#271
matbmoser wants to merge 2 commits intomainfrom
feat/architecture

Conversation

@matbmoser
Copy link
Member

Architecture Committee Task for publishing ADRs in the website

WHAT

  • Introduced a new sidebar for architecture documentation in docusaurus.config.ts.
  • Created initial ADRs for monorepo decision and versioning strategy.
  • Added category files for architecture and ADRs.
  • Implemented scripts for generating ADR PDFs and updating ADR index.
  • Updated package.json to include new scripts for ADR management.
  • Added placeholder certification documentation with a "Coming Soon" message.
  • Created versioned documentation for architecture across multiple versions.

WHY

The architecture committe wants to publish their ADRs in the website.

PENDING WORK

Automatizate the publication of the ADRs which are located at the cx-architecture repo -> catena-x.github.io

Closes #https://github.com/catenax-eV/cx-architecture/issues/57

- Introduced a new sidebar for architecture documentation in docusaurus.config.ts.
- Created initial ADRs for monorepo decision and versioning strategy.
- Added category files for architecture and ADRs.
- Implemented scripts for generating ADR PDFs and updating ADR index.
- Updated package.json to include new scripts for ADR management.
- Added placeholder certification documentation with a "Coming Soon" message.
- Created versioned documentation for architecture across multiple versions.
@matbmoser matbmoser marked this pull request as draft January 23, 2026 07:38
@matbmoser matbmoser marked this pull request as draft January 23, 2026 07:38
@matbmoser matbmoser changed the title feat: Add architecture documentation and ADRs feat: Add architecture documentation in architecture tab and ADRs Jan 23, 2026
@matbmoser
Copy link
Member Author

I made an initial work, which is not 100% ready, I need to remove some files before we publish, and make a bit more beautiful.

@stephanbcbauer
Copy link
Member

@matbmoser , please talk to @jSchuetz88 and myself before further working on this PR ... we want to reduce complexity on this static webpage and we already have some sync mechanism for standards, operating model and working model. Thx

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants