This page provides a brief overview of how your project is displayed in the software directory and how you can best customize it. Your publiccode.yml file is particularly important for this.

The following figure shows the details page of an entry in the software directory. The entries on the page have been assigned to the corresponding keys from the publiccode.yml file.

"Visualisierung der Werte aus der publiccode.yml im softwareverzeichnis

Frequently asked questions and problems

How do I add a description?

Under the description category, simple Markdown elements can be used to customize the formatting of your project description. For example, a description (longDescription) could look like this:

The above example also illustrates the various Markdown design elements that you can use for a description.

This description then appears as follows in the software directory:

Screenshot des obigen Beispiels einer Beschreibung im softwareverzeichnis

How can I assign my software to a software suite?

In publiccode.yml, you can assign your own software to a software suite using the softwareSuite key. This assigns the entry in the software directory to a parent project:

![Screenshot des Eintrags im softwareverzeichnis von einer Softwaresuite](/../assets/images/softwareverzeichnis/Screenshot-Eintrag-Software-Suite.png "Screenshot, welcher einen Ausschnitt aus dem Eintrag des softwareverzeichnisses der Software openDesk zeigt. In dem Ausschnitt sieht man die Tabs "Aktive Nutzung", "Teilprojekte" und den Hinweis, "Die Suite openDesk besteht aus verschiedenen Teilprojekten")

How do I add badges?

If your project meets the necessary requirements, it can be awarded various badges. These show the status of the project in terms of security, maintenance, and reuse. In the badge documentation, you will find more detailed information about the requirements for each badge and how to obtain them.

How do I submit a reuse?

To submit a reuse for a software, you must follow these steps:

  1. First, click on Submit use on the Activate Reuse page. You will now be redirected to the openCode search.
  2. Now open the project entry that matches your search term.
  3. After clicking on Submit use, the form for final confirmation of the corresponding reuse will open.

Once you have completed and submitted this form, you have successfully submitted the reuse.

Why is my project not displayed in the openCode software directory?

This is probably because your publiccode.yml file is incorrect or entries in your publiccode.yml file have been forgotten. Instructions for creating the publiccode.yml can be found here in the guide.