Skip to content

README.md: Modernize readme - #615

Open
JAB1305 wants to merge 3 commits into
eclipse-basyx:developfrom
rwth-iat:improvement/modernise-readme
Open

README.md: Modernize readme#615
JAB1305 wants to merge 3 commits into
eclipse-basyx:developfrom
rwth-iat:improvement/modernise-readme

Conversation

@JAB1305

@JAB1305 JAB1305 commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

Modernize readme
Closes #475
Superseeds / inspired by #490

Open (for discussion):

  • Keep RDF support feature? Is this relevant? (last activity apparently 2y ago)
  • Move Eclipse Contributor section to Contributing.md? (no mention there, at least duplicate?)
  • Badges for python min / python max point to not yet merged branch (Restructure versions to a single point of truth #610). Should point to main, note that dev readme would then always be outdated on version bump until merged. Acceptable?

@s-heppner

Copy link
Copy Markdown
Member

Thank you for the draft! Let me answer your questions:

Keep RDF support feature? Is this relevant? (last activity apparently 2y ago)

Yes, let's keep it and keep reference to it. If more people know the problems (#422) with it, the more IDTA might change something with their RDF schema.

Move Eclipse Contributor section to Contributing.md?

Makes sense to me. Somewhere we do mention in the CONTRIBUTING.md that you need an Eclipse Account and sign the ECA already.

Should point to main, note that dev readme would then always be outdated on version bump until merged. Acceptable?

Can we not have the badge refer to the current branch's central config file? I don't think a badge on develop with outdated version is good, if someone actively needs a new feature they'd be massively confused.

@JAB1305

JAB1305 commented Aug 25, 2026

Copy link
Copy Markdown
Contributor Author

Can we not have the badge refer to the current branch's central config file? I don't think a badge on develop with outdated version is good, if someone actively needs a new feature they'd be massively confused.

Unfortunately I was not able to find a way that allows for branch aware extraction of the version. The current version for the badge references a hardcoded raw.githubusercontent... URL that can in the future be either pointed to main or develop but have no way to just use "current". Also this method can only extract one value, so something like 3.10 - 3.12 in single badge would not be possible.

I think the two best options are either something like this:
MinMax
(Imagine different version here)
MinMax

Or to introduce a CI step that surfaces the versions, but that seems a bit overkill.

Also add a proper section in CONTRIBUTING.md and a notice at the top.
@JAB1305
JAB1305 marked this pull request as ready for review August 28, 2026 09:40
@s-heppner

Copy link
Copy Markdown
Member

I see. And what if we used: "Python min" from main and "Python max" from develop? Then it's technically correct at all times and hopefully the times where develop diverges from main should be small.
But then again, this is also a good argument to simply use the versions from main...

I don't have a good opinion.

@JAB1305

JAB1305 commented Sep 2, 2026

Copy link
Copy Markdown
Contributor Author

I am not sure if I like the idea of a merged range from main.min to dev.max as that is not what a potential reader would expect.

That would leave us with just having the main versions. What I would maybe add is something like:

Q: I am looking for a newer python version than the supported one on the release. Where can I find it?

A: Our develop branch will adopt newer python versions earlier than the latest main release. Currently - is supported there.

to the QA section?
Thats the idea I probably like most at the moment.

@zrgt zrgt linked an issue Sep 3, 2026 that may be closed by this pull request
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.

Modernise top-level README.md

2 participants