Task Page: Data Brokering

[Nazeeefa]

Data Brokering
New task page, by ELIXIR Converge WP9 team, that addresses how to get started as a data broker; how data and metadata collection and sharing should be done. The page covers key considerations, and provides solutions and recommendations that could help with how to share data within a well defined ethical and legal framework.

Are there existing pages in the RDMkit website related to the requested page?
The 'Data Brokering' task page can be added under "related pages" in the following page: Your Role - Data Steward: infrastructure

[bedroesb]

Hey Nazeefa! I changed the image filename so it does not contain (1) + updated the image syntax to be markdown.

[bedroesb]

https://rdmkit.elixir-europe.org/markdown_cheat_sheet#images the theme also allows to use the include image hat has the build in caption capability, but I should give the option to cutomize the width

[bedroesb]

updated some urls since it is advised to not use absolute linking towards internal pages (this way we are not sensitive to domain changes). I see you refer to multiple resources that are already in the tools table, could you at the data brokering tag to the spreadsheet of tools?

[bedroesb]

Some information about descriptive URLs

[floradanna]

@Nazeeefa Thanks for this contribution.

I would suggest to improve a bit the image:

• What are the empty squares with dark blue frame? Can this be made more clear in the image?
• Some icons have thicker then other. Could it be possible to you use icons more similar to each other?
• What is the rectangle with light blue frame? Does it represent also data providers? Could you make it more explicit please in the image.
• The light blue color is not very visible, maybe a color with more contrast?
• Could the arrows have the same color of the "origin" ? It would be easier to follow. See example below.
• Only Covid19 portal, GISAID and health authorities are present in the image. In my opinion, it gives the impression that this model only apply to health related domain. Maybe we could simply write "Local and international repositories" and then list few as examples. Also, Covid19 portal might not be the best example, since data are actually submitted to ENA, PRIDE, ArrayExpress etc... and only indexed by the portal.
• Is "authorities" in the caption the correct word? Maybe National health databases?
• The credits/licence of the icons could be written as separated paragraph under the caption or in smaller case/different font. I don't know. @bedroesb @martin-nc what do you think?

[martin-nc]

@Nazeeefa Sorry - I wasn't sure if I was supposed to do the diagram! What about this (not glamorous but it's at least in the brand colours and font!):

[martin-nc]

Alternative version. I think we could add icons to this, too, if desired:

[Nazeeefa]

Thank you so much @martin-nc I am happy with both versions, wondering if @alebrand prefers second one and want to add icons to it? :)

Apparently, I am unable to figure out how to upload the figure to this PR. Kindly upload whichever one is preferred by @alebrand or let me know and I'll figure out.

[aitananeves]

Dear all, thanks a lot, I think I prefer the first version with blank fills. Fine to go like this without icons, it makes the message more clear perhaps. Thank you very much for everything and for branding it!

[Nazeeefa]

Hi @floradanna, and @bedroesb: is it ok to merge this now? :)

[floradanna]

@Nazeeefa I have few comments on the text, I don't know if you have seen them. It would be better if you could address them, please.

[Nazeeefa]

@floradanna I think all your comments are addressed, kindly let me know if anything was missed. Thank you for your time and help.

[floradanna]

@Nazeeefa I had added comments but I didn't submit my review, so it was not visible to you but I didn't realise it before. Sorry about that. I have just now submitted my comments and you should be able to see them. In general, I would suggest to provide possible criteria to find solutions related to the listed considerations (see specific line above) and try to make the text a bit more generic and less ENA-centric (see specific comment above).

Sorry again for the misunderstanding.

[floradanna]

@Nazeeefa thank you.
Please, make sure that:

• contributors are listed in the https://github.com/elixir-europe/rdmkit/blob/master/_data/CONTRIBUTORS.yaml (if they want to)
• this page is listed in related Data life cycle pages (e.g., sharing) and Role (e.g., IT, data manager)
• this page is listed in https://github.com/elixir-europe/rdmkit/blob/master/_data/news.yml (if you want)

[floradanna]

@Nazeeefa you can merge! :)

[aitananeves]

thanks a lot everyone!

[bedroesb]

wait, is this done? :)

• contributors are listed in the https://github.com/elixir-europe/rdmkit/blob/master/_data/CONTRIBUTORS.yaml (if they want to)
• this page is listed in related Data life cycle pages (e.g., sharing) and Role (e.g., IT, data manager)
• this page is listed in https://github.com/elixir-europe/rdmkit/blob/master/_data/news.yml (if you want)

[bedroesb]

we can also do it afterwards off course

[Nazeeefa]

wait, is this done? :)

• contributors are listed in the https://github.com/elixir-europe/rdmkit/blob/master/_data/CONTRIBUTORS.yaml (if they want to)
• this page is listed in related Data life cycle pages (e.g., sharing) and Role (e.g., IT, data manager)
• this page is listed in https://github.com/elixir-europe/rdmkit/blob/master/_data/news.yml (if you want)

Update: @bedroesb all three suggestions are now addressed :)

[bedroesb]

oh I see you did it outside this Pull request, next time it is cleaner to add the tags in the same PR, because now there are tags on those pages about a page that does not yet exist :)

[bedroesb]

I will add the brokering tools too now :)

[Nazeeefa]

I noticed two of the links to ENA documentation were not working so I just updated with a few more changes (directly via GitHub) - hope that's fine?

[bedroesb]

Sure, this is post merge ;)

[Nazeeefa]

Hi @martin-nc, is it possible to make a tiny update to the figure? Apparently, the blue colour used for the figure (#3d68b0) is different from the one recommended by style guide (#376AC3). Thank you so much.

[Nazeeefa]

Update to page authors: to stay consistent with template and writing style of other "Your Task" pages on RDMkit, we will change headings for this page to questions. The template for "Your Task" pages currently says "Concrete problem 1, formulated as a question" for page section headings.

What this means in practice:

• the heading "Taking on the data broker role" can be changed to "How to take on the role of a data broker?"
• "Collecting and processing the metadata and data" to "What are the best practices for collecting and processing data and metadata?"
• "Sharing data to public repositories" to How to ensure effective sharing of data as a data broker?"

The suggested questions written above are just my suggestions, feel free to share what you would like to suggest :) Thanks, @wna-se @aitananeves @floradanna @bedroesb