6. Examples

Below there are two examples of publiccode.yml files, the first one represents the minimum configuration, which contains the mandatory fields, whilst the second one represents a more extended version.

6.1. Minimum Version

 1publiccodeYmlVersion: "0.2"
 2
 3name: Medusa
 4url: "https://example.com/italia/medusa.git"
 5softwareVersion: "dev"    # Optional
 6releaseDate: "2017-04-15"
 7platforms:
 8  - web
 9
10categories:
11  - financial-reporting
12
13developmentStatus: development
14
15softwareType: "standalone/desktop"
16
17description:
18  en:
19    localisedName: medusa   # Optional
20    shortDescription: >
21          A rather short description which
22          is probably useless
23
24    longDescription: >
25          Very long description of this software, also split
26          on multiple rows. You should note what the software
27          is and why one should need it. We can potentially
28          have many pages of text here.
29
30    features:
31       - Just one feature
32
33legal:
34  license: AGPL-3.0-or-later
35
36maintenance:
37  type: "community"
38
39  contacts:
40    - name: Francesco Rossi
41
42localisation:
43  localisationReady: true
44  availableLanguages:
45    - en

6.2. Extended Version

  1publiccodeYmlVersion: "0.2"
  2
  3name: Medusa
  4applicationSuite: MegaProductivitySuite
  5url: "https://example.com/italia/medusa.git"
  6landingURL: "https://example.com/italia/medusa"
  7isBasedOn: "https://github.com/italia/otello.git"
  8softwareVersion: "1.0"
  9releaseDate: "2017-04-15"
 10logo: img/logo.svg
 11
 12platforms:
 13  - android
 14  - ios
 15
 16categories:
 17  - content-management
 18  - office
 19
 20usedBy:
 21  - Comune di Firenze
 22  - Comune di Roma
 23
 24roadmap: "https://example.com/italia/medusa/roadmap"
 25
 26developmentStatus: development
 27
 28softwareType: "standalone/desktop"
 29
 30intendedAudience:
 31  scope:
 32    - science-and-technology
 33  countries:
 34    - it
 35    - de
 36  unsupportedCountries:
 37    - us
 38
 39description:
 40  en:
 41    localisedName: Medusa
 42    shortDescription: >
 43          This description can have a maximum 150
 44          characters long. We should not fill the
 45          remaining space with "Lorem Ipsum". End
 46
 47    longDescription: >
 48          Very long description of this software, also split
 49          on multiple rows. You should note what the software
 50          is and why one should need it.
 51
 52    documentation: "https://read.the.documentation/medusa/v1.0"
 53    apiDocumentation: "https://read.the.api.doc/medusa/v1.0"
 54
 55    features:
 56       - Very important feature
 57       - Will run without a problem
 58       - Has zero bugs
 59       - Solves all the problems of the world
 60    screenshots:
 61       - img/sshot1.jpg
 62       - img/sshot2.jpg
 63       - img/sshot3.jpg
 64    videos:
 65       - https://youtube.com/xxxxxxxx
 66    awards:
 67       - 1st Price Software of the year
 68
 69legal:
 70  license: AGPL-3.0-or-later
 71  mainCopyrightOwner: City of Chicago
 72  repoOwner: City of Chicago
 73  authorsFile: AUTHORS
 74
 75maintenance:
 76  type: "contract"
 77
 78  contractors:
 79    - name: "Fornitore Privato SPA"
 80      email: "dario.bianchi@fornitore.it"
 81      website: "https://privatecompany.com"
 82      until: "2019-01-01"
 83
 84  contacts:
 85    - name: Francesco Rossi
 86      email: "francesco.rossi@comune.reggioemilia.it"
 87      affiliation: Comune di Reggio Emilia
 88      phone: "+3923113215112"
 89
 90localisation:
 91  localisationReady: true
 92  availableLanguages:
 93    - en
 94    - it
 95    - fr
 96    - de
 97
 98dependsOn:
 99  open:
100    - name: MySQL
101      versionMin: "1.1"
102      versionMax: "1.3"
103      optional: true
104    - name: PostgreSQL
105      version: "3.2"
106      optional: true
107  proprietary:
108    - name: Oracle
109      versionMin: "11.4"
110    - name: IBM SoftLayer
111  hardware:
112    - name: NFC Reader
113      optional: true
114
115it:
116  countryExtensionVersion: "0.2"
117
118  conforme:
119    lineeGuidaDesign: true
120    modelloInteroperabilita: true
121    misureMinimeSicurezza: true
122    gdpr: true
123
124  piattaforme:
125    spid: true
126    cie: true
127    anpr: true
128    pagopa: true
129
130  riuso:
131    codiceIPA: c_h501