Re: [tractusx-dev] Tractus-X webpage - Upcoming Docusaurus Upgrade and R

[Stephan Bauer <stephan.bauer@xxxxxxxxxxxx>]

Hello Eclipse Tractus-X Community,

 

It took some time (was tough and a lot of work) but now right before the well-deserved weekend… work is finished.

 

Our Eclipse Tractus-X Webpage was updated. The Framework behind (Docusaurus) is now up to date with version 3.7.0.

What is in for you? TBH not that much. I think the only feature you can see is the “Grouped by year” in the news blog.

 

But it was critical to do the upgrade since we were on an outdated version of Docusaurus.

 

What else changed (This is what affects you as an KIT contributor), it was not just an upgrade, but also a cleanup:

• the KITs folder structure is updated ⇾ naming is over all KITs kebab-case ⇾ also the references are up-to-date
• labels for Software Development View (sometimes Development View) are renamed
• cleanup is done in all versions of the KITs (including current)
• in the sidebar and the Dropdown, the KITs are named in the same manner
• open-api and remote (docusaurus plug-ins) are deleted
• where possible, the api-hub was referenced in the related version
• node version was updated from 16 to 18 -> github actions/workflows
• a lot of (not all) broken links were fixes
• Full names of KITs in Dropdown and Sidebar

 

Known Knowns

• We still have some issues (warnings during build) with DRAW.io generated SVGS -> no worries, they are rendered correctly, but we must rethink here a little bit

 

What's your job

• Please have a look through your KIT, could be the case, that we missed something.
• Please create an issue in this case and best case -> fix it 😉
• Please check also the reference to the api-hub and the related swagger ui

 

To-dos after the BIG BANG merge (no worries about the big number of changes, I was always in contact with eclipse, and we had an excellent working model, during the migration)

• check changelog for broken links
• get feedback and collect issues -> if possible solve them on your own
• change EPL License in 11 files
• Tag the repository and delete 24.08 Kits -> makes it much faster
• update guidelines "how to adapt KITs, how to work with KITs"
• Add calendar to open meetings

 

BIG THANK YOU to all who helped and contributed

 

And now HAPPY WEEKEND

 

Stephan

 

 

 

Stephan Bauer 

Platform Domain Manager

 

Catena-X Automotive Network e.V. 
Reinhardtstr. 58 • 10117 Berlin 
Tel: +49 30 53607799  Mobil +49 151 67353921 

stephan.bauer@xxxxxxxxxxxx 

 

 

 

Folgen Sie uns auf LinkedIN 

 

Vereinsregister beim Amtsgericht Berlin (Charlottenburg) Nr VR38942B

Vorstandsvorsitzender: Oliver Ganser 

 

Book a meeting with me

 

 

 

From: tractusx-dev <tractusx-dev-bounces@xxxxxxxxxxx> on behalf of Stephan Bauer via tractusx-dev <tractusx-dev@xxxxxxxxxxx>
Date: Friday, 14. March 2025 at 12:33
To: tractusx-dev@xxxxxxxxxxx <tractusx-dev@xxxxxxxxxxx>
Cc: Stephan Bauer <stephan.bauer@xxxxxxxxxxxx>
Subject: [tractusx-dev] Tractus-X webpage - Upcoming Docusaurus Upgrade and Repository Maintenance Notification

Dear Eclipse Tractus-X Community,

following the successful completion and publication of Tractus-X Release 25.03, scheduled for March 17, 2025, we will commence an upgrade of our documentation framework (Tractus-X webpage) to version 3.X.

Key Details:

• Upgrade start: March 18, 2025

• Estimated Duration: 2 to 3 weeks (we aim to complete it sooner)

• Impact on Repository: The repository will be set to read-only mode during the upgrade period to prevent changes that could lead to significant merge conflicts.

• Website Availability: The website will remain accessible; however, updates will be paused until the upgrade is finalized.

How You Can Support:

We welcome community involvement in this upgrade process. If you’re interested in contributing or seeking more information, please visit the following GitHub issue.
-> Theresa, Johann and I are the initial team. We will work through each KIT, but support is welcome.

After the upgrade and migration, you can work as usual on your KITs.

In a nutshell:

• Update the Tractus-X website to Docusaurus 3.X to ensure security and library compatibility.
• Remove outdated plugins (Open API and remote) to maintain plugin compatibility and security.
• Transition KITs’ API specifications to be displayed via the new API Hub.
• Resolve MDX checker errors in KITs’ MDX and MD files for syntax compliance.

Stephan

 

Stephan Bauer 

Platform Domain Manager

 

Catena-X Automotive Network e.V. 
Reinhardtstr. 58 • 10117 Berlin 
Tel: +49 30 53607799  Mobil +49 151 67353921 

stephan.bauer@xxxxxxxxxxxx 

 

 

 

Folgen Sie uns auf LinkedIN 

 

Vereinsregister beim Amtsgericht Berlin (Charlottenburg) Nr VR38942B

Vorstandsvorsitzender: Oliver Ganser 

 

Book a meeting with me