elixir-europe / rdmkit

ELIXIR Data Management Toolkit - Find the answers to your research data management questions here.
https://rdmkit.elixir-europe.org
Other
84 stars 134 forks source link

A clearer definition of "resources" #1518

Open bianchini88 opened 3 months ago

bianchini88 commented 3 months ago

Description

Refer to https://rdmkit.elixir-europe.org/tool_resource_update

Whilst it is understandable what a tool is, the term "resource" is considerably more vague and open to interpretations. The possibility of linking with FAIRsharing would make one think that "standards", "databases", and "policies" are all to be considered as "resources" and should be in the yml file. In the case of standards, this is implemented e.g. for MINSEQE here. The same approach is, however, not implemented in many other pages (e.g. MIxS here).

Another interpretation of the FAIRsharing linking would be to use it for "standards", "databases" and "policies" which are supported by the various "tools" or "resources", in which case metadata standards should not be in the yml file. I am sure other interpretations are also possible.

Personally, I am in favour of the first interpretation, as it would provide richer information and the possibility of linking towards both the webpage of the "resource" and the registries (FAIRsharing, bio.tools, TeSS). One could also consider having other categories that behave as "tools" but use other icons (it would be weird to have that wrench icon close to e.g. a database or policy).

Independently from the paragraph above, we should clarify and be more explicit about what is a "resource" (i.e. what has to go in the yml file and what does not).

bedroesb commented 2 months ago

One of the things that resulted from this discussion is that the icon is a wrench and the code snippet uses the word {% tool "toolname" %}, which is not really applicable when it is a policy, standard, etc ...

bedroesb commented 2 months ago

Action list:

bedroesb commented 2 months ago

What do we think of this icon? @elixir-europe/rdmkit-editors image

bedroesb commented 2 months ago

I liked this one less: image

bedroesb commented 2 months ago

or this one: image

bianchini88 commented 2 months ago

@bedroesb I think I like the first one better (but I am notoriously not good at graphics).

diana-pilvar commented 2 months ago

I also like the first one more than others

marikapop commented 2 months ago

I do not like them all :( The most logical to me is the second one while being the most unattractive. The first is a compass for me, used to find North on a paper map.