Docs/release/23.2

[odzhychko]

This PR fixes the links in the documentation.

To achieve that, I created separate release branches (eg. docs/release/...) for documentation in each repository.

Compared to the previous tags, they have a name, that indicates a documentation release (eg. new docs/release/23.2 vs. old modelix-23.2).

Those documentation release branches can be fixed independently without modifying the release tag, which indicates the version of the software. (That is what I needed to do, to make the documentation build)

We could also use documentation release tags, if you see a reason for it. Personally, I agreed with Antoras statement about the drawbacks of tags for releases:

The downside of tags is that, once created, you can’t update them like you can with branches. So, if you find a typo, or need to add an example, you can’t edit the content in a tag. It’s frozen. You’d have to delete and recreate the tag, or create a new tag and point to it, in order to publish your updates.

See https://docs.antora.org/antora/latest/content-source-versioning-methods/#version-content-using-tags

Related

It relates to and should be merged after:

• docs: remove the version from the component modelix.core#311
• docs: remove the version from the component modelix.samples#176
• Docs/release/23.2 modelix.platform#9

It relates to newly created, branches that can be reviewed, but do not need to be merged:

• modelix/modelix.core@main...docs/release/23.0
• modelix/modelix.core@main...docs/release/23.1
• modelix/modelix.samples@main...docs/release/23.0
• modelix/modelix.samples@main...docs/release/23.1
• modelix/modelix.platform@main...docs/release/23.0
• modelix/modelix.platform@main...docs/release/23.1

Side notes

Regarding this topic, I added two points to our weekly:

1. Do we want to publish docs for older versions 23.0 and 23.1?
2. Where do we want to document details about the structure of the documentation setup?

[odzhychko]

The failing build can be ignored until we merge the pull requests in the individual components.

[odzhychko]

The build is failing. It seems to be the case, because it uses the main branch from modelix.docs. I'm looking into it.