Skip to content

chore: Split FAIR documentation and update links - #562

Merged
jliermann merged 3 commits into
localisationfrom
chore/split-fair
Oct 30, 2026
Merged

jliermann merged 3 commits into
localisationfrom
chore/split-fair

Conversation

@jliermann

Copy link
Copy Markdown
Contributor

This pull request restructures the documentation for the FAIR Data Principles by splitting a single long document into multiple focused files, each addressing a specific principle (Findable, Accessible, etc.). The content is reorganized for better clarity and navigation, and the main introduction is streamlined to improve readability.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The split breaks existing incoming links to section fragments on /docs/fair/ because the legacy anchors were removed without preserving navigation to the moved sections.

1 open issue
What changed in this PR

This PR reorganizes the knowledge base’s FAIR guidance into an introduction and four principle-specific pages, making the content easier to navigate.

Changes:

  • Splits Findable, Accessible, Interoperable, and Reusable guidance into separate pages.
  • Adds a FAIR sidebar category while retaining the /fair introduction URL.
  • Updates cross-page links and publishing-standard references to the new locations.
File Description
docs/​50_data_publication/​70_publishing_standards/​30_publishing_standards_infrastructure.mdx Updates F2 and A2 links.
docs/​50_data_publication/​70_publishing_standards/​20_publishing_standards_publishers.mdx Updates the A1 link.
docs/​00_intro/​10_fair/​50_reusable.mdx Adds standalone Reusable guidance.
docs/​00_intro/​10_fair/​40_interoperable.mdx Adds standalone Interoperable guidance.
docs/​00_intro/​10_fair/​30_accessible.mdx Adds standalone Accessible guidance.
docs/​00_intro/​10_fair/​20_findable.mdx Adds standalone Findable guidance.
docs/​00_intro/​10_fair/​10_fair.mdx Retains the introduction and further resources.
docs/​00_intro/​10_fair/​_category_.json Groups FAIR pages under a linked sidebar category.
docs/​00_intro/​10_fair.mdx Removes the original combined document.

Review effort: Balanced

Comment thread docs/00_intro/10_fair/10_fair.mdx Resolved
@jliermann
jliermann merged commit ff417b3 into localisation Oct 30, 2026
7 checks passed
@jliermann
jliermann deleted the chore/split-fair branch October 30, 2026 14:14
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