Changelog
handbook
3.8.0
- Redesigned to the EBRAINS design system’s current styles: headings, body text and links now match the other EBRAINS documentation sites. The homepage figures are static (no counting animation).
- EBRAINS Design System is now its own section under Technical, with a new tutorial, “Build an EBRAINS App with Vite and React”, for apps in their own repository, a guide to choosing a setup, and “Customise Your App’s Tailwind Config”. Old links redirect.
- The EBRAINS UI Ecosystem section is a step-by-step path (set up the monorepo, create an app, add the design system, build a dashboard), with every step checked on a freshly generated app, and a new “Build an EBRAINS Dashboard” tutorial.
- The Tailwind Class Reference is generated from the design tokens, so it lists the classes that actually exist (
node apps/live/handbook/jobs/gather-tailwind-reference.js). - Broken links fixed across sections.
3.7.0
2026-11-03
- Focused the public handbook on user-facing content: internal team-process material (project management, technical-coordination tooling, and internal organisation pages) is no longer published, and the Reference section now keeps only the EBRAINS-specific essentials.
- Readability improvements on smaller screens: right-sized headings, more comfortable body text, and clearer, consistently styled inline links.
3.6.0
2026-10-12
- New EBRAINS Ready section under Tools and Resources: a tutorial to assess your first service, and guides to add services in bulk, move a service up a level and show its level with a badge.
- The TRL methodology EBRAINS Ready uses is now published there: how a level is decided, the TRL levels, the checklist each kind of service is assessed against, and how the rubric is versioned and evidence corrected.
- New “How to Contribute with the Assistant” page in About the Handbook, for contributing pages through contribute.handbook.ebrains.eu.
3.5.1
2026-09-30
- Fixed the header search on the homepage and a few other pages (Working Together, Appendices, Glossary) returning no results: they had been published from a local build and searched
localhostinstead of the live search service. - The build now starts from an empty output folder and fails if any page still carries local-only output (a
localhostsearch address, a “Local”/“Dev” site title, or the dev-server reload script). - The local dev server (
nx run handbook:serve) now renders in memory, so it can no longer overwrite a production build.
3.5.0
2026-09-29
- New Patient and Public Involvement and Engagement (PPIE) pages: understanding PPIE, planning PPIE for your project, and PPIE guidelines and resources.
- Automated registration page links to the CodeMeta Generator app.
- Contributors page removed.
3.4.1
2026-09-10
- Support contact (mail) added to the national node (NN) membership and governance pages.
3.4.0
2026-09-08
- New content on national node (NN) membership and governance.
3.3.4
2026-06-19
- Sections and pages renamed for a clearer outline.
- Additional sections for the OMF pages.
- The shared Hugo theme is now its own Nx project (
shared-hugo), so changes to it rebuild the handbook.
3.3.3
2026-06-05
- New page on verifying an SME.
- Small styling fixes.
3.3.2
2026-05-27
- Glossary restyled, with an improved glossary gathering job.
- New
eds-form-embedshortcode to embed an EBRAINS public form in a page.
3.3.1
2026-05-20
- Header: narrower search pill (width configurable via
params.navbar.searchWidth), with ⌘K as the main way in. - GitLab and Support text links in the header replaced by a GitLab icon button (URL configurable via
params.navbar.gitlabUrl). - Breadcrumb: earlier steps muted, the current page emphasised.
3.3.0
2026-05-20
- New brand-aligned sidebar variant (
sidebar-brand) with numbered top-level sections, chevron-toggled disclosure, green active-bar indicator, and recursive nesting for sub-sections. - Configurable sidebar via
params.sidebar.variant(classicorbrand); handbook opted intobrand. - Top-level sections grouped under labelled headings —
Newcomers,Daily Work,Technical,Reference— driven bysidebar.groupfrontmatter on each section’s_index.md.
3.2.0
2026-05-08
- Glossary added
- minor content fixes
3.1.0
2026-04-03
- devops-docs reference added
- guest accounts content fix
- fix boken lab tutorials link
3.0.0
2026-01-10
- New updated look and feel based on the new visual system
- New outline, sections, and pages
2.16.0
2025-11-20
Minor Changes
- search functionity updated
- content fixes
2.15.2
2025-11-13
Patch Changes
- content fixes
2.15.1
2025-11-13
Patch Changes
- Search config set to “content”
- content fixes
2.15.0
2025-10-27
Minor Changes
- Request Resources section updated.
- Fixed header menu on small screens.
- Added forms.ebrains.eu in collaboration tools.
- Minor layout improvements.
2.14.0
2025-09-26
Minor Changes
- New Forms App section content added
2.13.1
2025-08-14
Patch Changes
- Moved sidebar toggle icon (
chevron) to the left of the link in the handbook sidebar for improved visual alignment and usability. - Added placeholder spacing for items without children to keep link text aligned with items that have toggle icons.
- Fixed
chevronrotation issue for smoother expand/collapse transitions.
2.13.0
Minor Changes
01-07-2025
- Getting started section updated
- How-to integrate your service with EBRAINS Stats (Matomo) added
2.12.1
Patch Changes
10-06-2025
- Fix layout page width
2.12.0
Minor Changes
10-06-2025
- Main layout updated
- Content fixes and layout improvements
2.11.1
Patch Changes
29-05-2025
- Content fixes and layout improvements
2.11.0
28-05-2025
Minor Changes
- Layout and content improvements
- Version header dropdown display added
- Internal links new style (underline)
- Added link “View all sections” in home
2.10.4
- No changes
2.10.3
- No changes
2.10.2
Patch Changes
- Sync ebrains/components (eds-steps, eds-modal, eds-breadcrump, eds-matomo-notice) and various content updates
2.10.1
Patch Changes
- Fixed redirect links and content
2.10.0
Minor Changes
- Content fixes and layout improvements
2.9.0
Minor Changes
- Content and layout improvements
2.8.0
Minor Changes
- Introduce footer and analytics improvements
2.7.0
Minor Changes
- Various content and layout fixes
2.6.0
Minor Changes
- Editing the Handbook/Contribution Workflow section has been refactored.
- Editing the Handbook integrating with the Design System added.
- Technical Deep Dive/Handbook section has been re-structured.
- Technical Deep Dive/Design System section has been re-structured.
- Technical Deep Dive/EBRAINS UI Ecosystem section has been added.
2.5.0
Minor Changes
- Content added and layout improvements
2.4.0
Minor Changes
- Updated kg/automated-registration.md sections and various content fixes
2.3.0
Minor Changes
- Content added and layout improvements
2.2.0
Minor Changes
- Added new OMF subsections and Grafana access guide
2.1.0
Minor Changes
- Content and layout improvements
2.0.0
Major Changes
- Integration with the EBRAINS Design System. Development of Hugo shortcodes and partials
1.0.0
Major Changes
- First major release of the EBRAINS Handbook. It includes new sections and layout adaptations.