Last modified by adavison on 2024/11/13 10:32
From version 9.1
edited by jan
on 2022/11/23 11:03
Change comment: There is no comment for this version
To version 17.1
edited by jan
on 2022/11/30 11:22
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -swc-guide
1 +Guide to Software Curation in the EBRAINS Knowledge Graph
Content
... ... @@ -1,18 +1,24 @@
1 -
1 += Contents =
2 2  
3 -**For any questions or support directly reach out to [[Jan Gründling>>mailto:gruendling@uni-trier.de]].**
3 +{{toc start="2"/}}
4 4  
5 -This guide provides a starting point and reference for the process of entering information about your software into the EBRAINS Knowledge Graph (KG). There are two ways, the manual and the programmatical one:
5 +This guide provides a starting point and reference for the process of entering information about your software into the EBRAINS Knowledge Graph (KG).
6 6  
7 +For an overview of the software curation process, please refer to [[our info graphic>>https://drive.ebrains.eu/lib/f5cf4964-f095-49bd-8c34-e4ffda05a497/file/EBRAINS-Share-Software.pdf]].
8 +
9 +**For any questions or support directly reach out to [[Jan Gründling>>mailto:gruendling@uni-trier.de]].**
10 +
7 7  == How to enter software metadata manually ==
8 8  
13 +If your software has not been curated before, please fill in the request form [[here>>https://nettskjema.no/a/104328]] before continuing with the following instructions. If your Software has been curated already and you want do add a new version, refer to the section [[How to Update>>https://wiki.ebrains.eu/bin/view/Collabs/swc-guide#HHowtoupdateexistingSoftwareinstances]].
14 +
9 9  You will receive an email after the curator has created a space for you in the Knowledge Graph. This email contains a link to a software instance and a software version instance in your Space. These are already linked to each other (by the attribute "Has Version" of the software instance).
10 10  
11 11  **Before explaining the editing process, here are some helpful links:**
12 12  
13 13  * A description of the fields of the software and software version instances and values that these fields may take: [[https:~~/~~/humanbrainproject.github.io/openMINDS/v2/core/v3/products/softwareVersion.html>>url:https://humanbrainproject.github.io/openMINDS/v2/core/v3/products/softwareVersion.html]] and [[https:~~/~~/humanbrainproject.github.io/openMINDS/v2/core/v3/products/software.html>>url:https://humanbrainproject.github.io/openMINDS/v2/core/v3/products/software.html]]
14 -* additional information for each attribute: [[Attribute Description>>doc:.EBRAINS Knowledge Graph guide for software curation.Attribute description.WebHome]]
15 -* a detailed description of the software features: [[Software Features>>doc:.EBRAINS Knowledge Graph guide for software curation.Software Features.WebHome]]
20 +* Additional information for each attribute: [[Attribute Description>>doc:.EBRAINS Knowledge Graph guide for software curation.Attribute description.WebHome]]
21 +* A detailed description of the software features: [[Software Features>>doc:.EBRAINS Knowledge Graph guide for software curation.Software Features.WebHome]]
16 16  
17 17  **Editing the software and software version instances:**
18 18  
... ... @@ -40,12 +40,14 @@
40 40  
41 41  The curators will check the new software instances and move them to the correct space.
42 42  
43 -=== How to update an existing Software instances ===
49 +== How to update existing Software instances ==
44 44  
45 45  If you have registered a software previously, updating means adding a new instance of type "Software version". Curators will later link it to the existing instance of type "Software".
46 46  
47 -To make updating easier, we have already placed a copy of your last software version instance in the KG space that was created for you. You can use that copy and just change the fields that require changes. Again - if you made all changes that you consider necessary, let the curator know via email or the ticket assigned with this case.
53 +**If you want to add a new version to an already curated software, please write to [[curation-support@humanbrainproject.eu>>path:mailto:curation-support@humanbrainproject.eu]] or open a ticket at [[https:~~/~~/support.humanbrainproject.eu/>>url:https://support.humanbrainproject.eu/]]**
48 48  
55 +To make updating easier, we place a copy of your last software version instance in the KG space that was created for you. You can use that copy and just change the fields that require changes. Again - if you made all changes that you consider necessary, let the curator know via email or the ticket assigned with this case.
56 +
49 49  == How to upload software metadata programmatically ==
50 50  
51 51  To create a valid jsonld file, please use the [[API>>https://core.kg.ebrains.eu/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config]].
... ... @@ -55,8 +55,3 @@
55 55  Before using it, you need to authorize, using the "Authorize" button found in the top right corner of the API documentation (see below) or by using a service account.
56 56  
57 57  [[image:Collabs.swc-guide.EBRAINS Knowledge Graph guide for software curation.WebHome@image-20220323111341-2.png||height="74" width="186"]]
58 -
59 -(% class="col-xs-12 col-sm-4" %)
60 -(((
61 -Please read the [[Guide>>doc:.EBRAINS Knowledge Graph guide for software curation.WebHome]].
62 -)))