Datahub’s documentation is moving to the wiki format

Until now, the documentation for the Datahub system has only been available as downloadable documents. In autumn 2024, we conducted a survey and customer interviews to gather user feedback on the documentation. Key issues identified included finding up-to date information, as well as the large number of documents. Additionally, the documentation pages in the service portal were considered difficult to use.

Based on the results of the study, we created a wiki prototype and collected feedback on it during April 2025. The feedback was positive, and the test wiki received a rating of 4 out of 5. Based on this, we decided to adopt the wiki as the new documentation solution for Datahub.

Our solution includes two separate spaces for the main documentation: one for the current Datahub version and one for the upcoming version. Instructions will be found in the current version’s space as soon as we get them transferred to the wiki.

The different wiki spaces are permanent and always updated with the latest content. This ensures that users’ bookmarks or links will not stop working (unless, for example, a Datahub message and thus its page are removed), and they will always lead to valid content. The current version’s space will always contain the documentation for the version in production, even when the Datahub version changes. Documentation for outdated system versions will be available as a compiled PDF under an Archive section.

The English documentation will follow the structure of the Finnish wiki and will be available in autumn in the current version’s and the upcoming version’s spaces. Different language versions will not be mixed in the same space, except in cases where certain information exists only in one language.

Key changes compared to the current document-based system:

• The wiki uses a tree structure, and each topic has its own subpage. There are no 400 pages long documents. Instead, there are many subpages with shorter content.

• Datahub can update texts whenever needed, and users can see when each page was last updated. The page history shows what kind of change was made.

• When version-specific changes are made to a particular wiki page (e.g., the content or structure of a message is changed), the page is marked with a stamp for that Datahub version. This allows users to track, for example, the change history of a specific process description by version: the process was updated in versions 2.5 and 2.6, but not in 2.7.

• In the documentation for the upcoming version, text sections that differ from the previous version are highlighted. All pages with version-specific changes are marked with the corresponding Datahub version stamp. This enables us to provide a dedicated summary page that lists only the changed pages (and the changed text sections within them). The summary page also briefly describes the changes. This means users don’t need to manually search the entire documentation for updates. This functionality is available starting from version 2.6.

• Users can export wiki pages to PDF or Word format if they wish. Datahub also provides some precompiled summary pages where all subpages of a specific topic are combined.

• The wiki allows for much more flexible internal linking between content than the current document-based system.

Search this space (Datahub 2.5):

Recent updates