Skip to content
Start a project

Docs · Knowledge base

OKFN Knowledge Base

OKFN Germany's Open Data knowledge base, built on BookStack.

Visit site (opendata.okfn.de)
Year
2023
Type
Docs, Knowledge base
Stack
PHP, BookStack, MySQL
Live site
opendata.okfn.de
OKFN Knowledge Base, the live site on a device

About the project

The Open Data Knowledge Hub is a German-language reference on open data, maintained by the Open Knowledge Foundation Deutschland together with the Code for Germany community.

Documentation on open data in Germany was spread across folders and documents, with no central place. Readers needed guides sorted by topic and by federal state. We set up a BookStack instance and organised the material into books.

What we did

  • BookStack setup and configuration
  • Structure of books and chapters
  • Visual adjustments to match the organisation
  • Hosting and maintenance setup

Case study

Challenge

Documentation about open data in Germany was scattered across different folders with no centralized location. German-speaking readers needed structured guides organized by topic and federal state.

Solution

We set up a BookStack instance with books organized for open data in practice, risks to avoid, and policies by federal state. The platform allows comments and links to the community Slack channel.

Results

The community has a shared, searchable reference for open data documentation, with comments and links for further discussion.

Screens

OKFN Knowledge Base, the live site
Desktop capture, 1440 px
OKFN Knowledge Base, mobile screen
Phone capture, 390 px

In detail

  • Books instead of folders

    The material is sorted into books: the basics of open data, open data in practice, portals and contact persons, the legal framework at federal, state and European level, and what to avoid. A reader chooses a book the way they would pick one from a shelf.

  • Search across everything

    BookStack searches the full text of every page. Someone in a public administration with one precise question can find the paragraph without knowing which book it is in.

  • A reference that stays current

    Pages can be edited in the browser and keep their revision history, and readers can comment. Contributors are pointed to the community's chat channel, so the reference grows with the people who use it.

How it is built

BookStackContent management
An open source documentation platform that organises pages into chapters and books, with full-text search and page revisions.
PHPBackend
The server language behind WordPress and BookStack, supported by almost every hosting provider.
MySQLDatabase
The relational database that stores the pages, revisions and user accounts.

Lighthouse scores

Performance
99
Accessibility
95
Best practices
100
SEO
92

Lighthouse desktop scores, measured on the live sites.

Start with a price, then a conversation.

Build an estimate in a couple of minutes, or tell us what you need and we will outline the work, price and schedule.