Go to the main content
29/08/2023 - 29/08/2023 - 10:00-12:00 CESTOnlineRegister now

Clear and comprehensive documentation is absolutely essential for a service – or any resource – to be discoverable and successfully used, both by existing and potential new target groups. There are many components of service documentation, including service catalogue entries, promotional materials, usage instructions and tutorials, technical specifications and richly commented code. 

As an example of the first of these, a brief description (answering the questions What? For whom? and Why use?) is a required metadata item to be provided during the onboarding of all resources into the EOSC Marketplace.

In this workshop, we will start by giving an overview of relevant documentation types, and discuss some strategies for creating sustainable, effective and end-user-friendly descriptions. This will be followed by practical hands-on exercises focusing on how to prepare service descriptions according to the requirements of the EOSC onboarding protocol. 

So bring your own service use case along, and join what we hope will be an interactive and productive description writing session!


10:00-10:05Welcome & “housekeeping”
10:05-10:25Service documentation: what, why & how – Maggie Hellström
10:25-10:50Exercise 1: examples of  service descriptions in the EOSC Marketplace
11:00-11:50Exercise 2: describe your own service!
11:50-12:00Summary & wrap-up


Main instructor:

Dr Maggie Hellström – research data management specialist at the ICOS Carbon Portal and co-lead of the work package on training & capacity building of the ENVRI-FAIR cluster project.


Zoom RegistrationDeadline: August 28, Close of Business