Missing Pages, Broken Links, 404 Errors

[mhellmeier]

Bug Report

Describe the Bug

(This is just one example. See the comments for further pages and infos.)

The following page is shown in the menu ("Best Practices") but leads to a "Page not found" error: https://eclipse-edc.github.io/docs/#/submodule/Connector/docs/developer/best-practices

Expected Behavior

A best practices page is shown.

Observed Behavior

A 404 error is shown.

Steps to Reproduce

Steps to reproduce the behavior:

1. Visit https://eclipse-edc.github.io/docs/#/submodule/Connector/docs/developer/best-practices
2. See error

Context Information

Add any other context about the problem here.

• Usage of published version at https://eclipse-edc.github.io/

Detailed Description

./.

Possible Implementation

./.

[github-actions[bot]]

Thanks for your contribution :fire: We will take a look asap :rocket:

[mhellmeier]

Different links are also broken in the documentation. Some examples:

• At https://eclipse-edc.github.io/docs/#/submodule/Connector/docs/developer/decision-records/ all links to the 404 records are broken
• Data Dashboard Documentation is broken: https://eclipse-edc.github.io/docs/#/submodule/DataDashboard/docs/developer/
• Descision Records are broken: https://eclipse-edc.github.io/docs/#/submodule/DataDashboard/docs/developer/decision-records/
• Federated Catalog Documentation broken: https://eclipse-edc.github.io/docs/#/submodule/FederatedCatalog/docs/developer/
• Identity Hub Documentation Broken: https://eclipse-edc.github.io/docs/#/submodule/IdentityHub/docs/developer/
• Registration Service Documentation Broken: https://eclipse-edc.github.io/docs/#/submodule/RegistrationService/docs/developer/
• Trust Framework Adoption Documentation Broken: https://eclipse-edc.github.io/docs/#/submodule/TrustFrameworkAdoption/docs/developer/
• ...

[ndr-brt]

thanks for reporting, yes, a lot of links definitely need some love

[ndr-brt]

Different links are also broken in the documentation. Some examples:

• At https://eclipse-edc.github.io/docs/#/submodule/Connector/docs/developer/decision-records/ all links to the 404 records are broken

not all of them, only the ones that miss the trailing slash, this is a docsify issue, but I'm not sure it will be ever solved: https://github.com/docsifyjs/docsify/issues/1018

• Data Dashboard Documentation is broken: https://eclipse-edc.github.io/docs/#/submodule/DataDashboard/docs/developer/
• Descision Records are broken: https://eclipse-edc.github.io/docs/#/submodule/DataDashboard/docs/developer/decision-records/
• Federated Catalog Documentation broken: https://eclipse-edc.github.io/docs/#/submodule/FederatedCatalog/docs/developer/
• Identity Hub Documentation Broken: https://eclipse-edc.github.io/docs/#/submodule/IdentityHub/docs/developer/
• Registration Service Documentation Broken: https://eclipse-edc.github.io/docs/#/submodule/RegistrationService/docs/developer/
• Trust Framework Adoption Documentation Broken: https://eclipse-edc.github.io/docs/#/submodule/TrustFrameworkAdoption/docs/developer/
• ...

these 404 are given by the fact that these projects don't contain either docs/developer/README.md file or docs/developer/decision-records/README.md

[mhellmeier]

This Issue needs to be reopened since the problem is still present because most of the links mentioned here still don't work.

[ndr-brt]

This Issue needs to be reopened since the problem is still present because most of the links mentioned here still don't work.

these are issues to be addressed in the related repos, nothing can be done here. one was already solved in the connector one: https://github.com/eclipse-edc/Connector/pull/4257

(please note that the update of the submodules docs happens once in a week, on monday)