Adding software
Before you can add software, you will need to get access to the RSD. See How to get access and Sign in.
After signing in, you can use the "+" button next to your avatar icon on the top right of the page. Select "New Software" from the drop-down menu.
To create a new software page provide a name and a short description (optional) of what your software does. Once you click "Save" the RSD will use this information to create a new software page. Next, you can add additional information using the sections explained below.
Description
In this section, you can provide the basic information about the software, like a description of the software, which will be shown on the software page. You can use custom markdown to write the description or link to existing markdown page on the web.
Custom markdown
The custom markdown supports basic markdown features: titles, bullet points, code area, simple table, task list, links and the images. The example below demonstrates widely used markdown features in RSD.
<!--This section starts with What {software name} can do for you-->
Good practice at eScience Center was to start this section with a number of bullets that answer the question
- Main reason number 1 why this software is useful to someone else
- Main reason number 2
- Main reason number 3
- Main reason ...( 3 to 7 points would be most useful in my opinion)
## Subtitle
Another section with subtitle
## Code area
Use `three backticks` to create code area
``bash
This example is code area
``
## Simple table
|column 1| column 2| column 3|
|-|-|-|
|123242|234234|3
|some text here|34|x=23|
## Task list
* [x] Do this first
* [ ] Then this
* [ ] And this at last
## Links
[This is a link to Google](https://www.google.nl/)
## Images
You need an image that allows CORS reference, otherwise image will not be loaded
Document URL
You can link to a remote Markdown file which will be dynamically loaded by the RSD. An often used approach is to link to a readme file on the GitHub repository. In this case you need to link to the raw version of the readme file. For example, to link to the readme file of the RSD repository, we used the link https://raw.githubusercontent.com/research-software-directory/RSD-as-a-service/main/README.md. Note that the url domain is different https://raw.githubusercontent.com/ from the default GitHub domain (https://github.com).
When using a Document URL to point to a remote markdown file on the GitHub, you need to provide a URL to a raw markdown file (see the animation below). In addition, all links used in the Markdown document need to be absolute (https://...). This is required, because Markdown content is loaded from the GitHub domain into the RSD website.
Logo
The software logo is shown on the software page and in the software card (see example below). You can upload an image up to 2MB of size. Widely used image formats like jpg, jpeg, png, svg etc. are supported. Use the svg format, if possible, because it scales better than other formats.
Links & metadata
Software URLs
-
A Source code repository URL of the software. This link will show up as a repository icon on the software page and will be used to harvest information about the software development activity, which will be shown as a graph. At the moment we support GitHub, GitLab and have limited support for Bitbucket. The platform is automatically detected from the http domain, but can be changed manually.
-
A Getting started URL which refers to webpage with more information about the software. This is shown as the "Get started" button on the software page.
Software DOI
The software DOI will be used to automatically detect new releases of your software, and generate the block with citation information shown on the software page. You can find more information on DOI versioning at Zenodo.
After providing a DOI, use the "Validate" button to confirm that provided DOI is valid "Concept/Software" DOI. If the provided DOI is a version DOI, and RSD is able to find the concept DOI, it will update the DOI and notify you about the change.
After providing a valid software DOI, you will have the option to import keywords, software license and contributors provided in the DOI metadata.
Keywords
The keywords describing your software. These will be shown in the sidebar of the software page. Users can filter all software entries by keywords. If you provided a software DOI and have keywords defined in this DOI, you can import them using the "Import keywords" button.
When you start typing the keyword you will see a list of suggestions based on the keywords already present in RSD.
License
The License of the software. This will be shown in the sidebar of the software page. If you have provided a software DOI you can import the license info from DOI metadata.
When you start typing the license you will get a list of valid open source licenses pulled from the SPDX repository.
Contributors
In this section, you can provide more information on who contributed to the software. This section can be used to list the developers, designers, community managers, etc.
You can use the search bar underneath "Add contributor" to search for people already registered in the RSD or ORCID database. If needed, you can add a role and an affiliation to the contributor, and select one contributor as a "contact person" for the software.
The contributors you add will show up in the contributors section of the software page.
If you have provided a Software DOI in the previous section, you can import the contributors from the DOI metadata by clicking the "Import contributors" button (see animation).
Contact person
One of the contributors can be defined as contact person. The contact person will appear in a separate card and the email button will be displayed if an email address is provided.
- Only one person can be shown in the card as a contact person.
- Please ensure the contact person has a valid email address.
Organisations
In this section, you can list which organisations contributed to the development of the software. You can use the search bar underneath "Add organisation" to search for organisations already registered in the RSD or in the ROR database.
Mentions
This section allows you to add mentions to your software page. You can use this to list reference papers, publications, presentations, videos, blogs, etc. that prominently feature your software, or the results produced by your software.
Reference papers
Use the Search box on the right hand side to find papers by DOI or title. All the relevant data about the publication will be retrieved automatically. A background scraper will use OpenAlex to collect all citations of the reference papers.
Citations
All the results RSD scraper was able to find on OpenAlex citing provided reference papers. It can take a few minutes before the citations are harvested.
You cannot edit this section. All entries are automatically generated by the RSD scraper service. The found mentions are displayed in the mentions section of the software page.
Related output
Here you can add all additional related output. Use search to find papers or other publications by DOI or title. It is also possible to bulk add mentions, that have a DOI (use the Import button). On the popup, you can add one DOI per line, with a maximum of 50. After clicking on the Next button, we will fetch the data, which can take a moment. When that is done, you will see an overview of the data we fetched, including possible errors, where you can check the data and possibly disable some of the mentions.
Testimonials
This section allows user testimonials to be added to the software page. A testimonial consist of a quote and a source. The source is a free text field. In the source field you can provide name, date, location or anything else in any order and format you wish.
Package managers
If your software is available through a package manager like Anaconda, PyPi or Docker Hub, you can add links to those here. We will use these to scrape some data like download count and the number of packages that depend on your software. We do not show this info on the public view of your page, as we're still in the process of figuring out how much data we can harvest and how to present this in the best way. It would therefore be very helpful if you add this information to your software page.
We currently support the following package managers: Anaconda, Cran, Chocolatey, Debian, Docker Hub, GitHub, Gitlab, Go, Maven, npm, PyPI, Rust, Sonatype, Snapcraft.
If your package manager is not listed above, you can still add it, but we will categorise it as other and cannot scrape it yet. You can open an GitHub issue (please check for existing issues first) or contact us if you want us to support an additional package manager.
Related software
The related software sections can be used to link related software pages in the RSD to this software page. Items can be added by simply typing (part) of the name in the search bar and selecting the desired item from the search result list.
Related projects
The related projects sections can be used to link related project pages in the RSD to this software page. Items can be added by simply typing (part) of the name in the search bar and selecting the desired item from the search result list.
Maintainers
Here, you can see all the people who can maintain this software page. You can also create invitation links to send to people you want to give maintainer access and see and delete all unused invitations.
Background services
Here you can find the information about the background services that RSD offers and their last status.
Please check this section from time to time to confirm that information you provided is correct and that RSD background services are able to use provided information in the proper way.
The finished page
Once you are satisfied with the data you have entered for the different sections, you can publish the software page to make it publicly available. Don't hesitate to update and extend the page later!
