New schema changes (#23)

* fix: switched yaml references to yml
* switched from spinal-case to camelCase 
* fix: switch to plurals instead of List in keys
* fix: fixed typos
* feat: Added repo info in README
* feat: Converted settings file to italian
* feat: added Italian README and Italian index page

Author: libremente

README.it.md

@@ -0,0 +1,80 @@
+# Lo Standard `publiccode.yml`
+
+`publiccode.yml` è uno standard di metadati adatto a repository
+di software pubblico e di policy. Questo standard ha lo scopo
+di rendere il software sviluppato dalle Pubbliche Amministrazioni e Pubbliche
+Organizzazioni facile da individuare e, di conseguenza, riutilizzare. Proprio
+per questo motivo, è stato pensato per essere semplice da adottare sia per gli
+sviluppatori che per i non addetti ai lavori. 
+
+## Versioni
+
+**Ultimo rilascio: [Versione
+0.1](https://github.com/italia/publiccode.yml/releases/latest)**
+
+[Vedi tutte le versioni](https://github.com/italia/publiccode.yml/releases)
+
+Questo progetto aderisce al modello di versioning [*Semantic
+Versioning*](https://semver.org/).
+
+Inoltre, questo progetto usa i *branch* e i *tag* di git nel seguente modo:
+* il branch `master` contiene l'ultima versione stabile dello standard;
+* il branch `development` contiene gli aggiornamenti proposti e in discussione
+  per la prossima versione dello standard;
+* La [release page](https://github.com/italia/publiccode.yml/releases) di
+  GitHub contiene tutte le versioni rilasciate dello standard. Le *release*
+  sono effettuate seguendo il nome del tag per questioni di coerenza (ad es.,
+  il tag `v0.1` implica una release denominata `v0.1`). 
+
+Le specifiche `publiccode.yml` sono sviluppate dal [Team per la Trasformazione
+Digitale](https://teamdigitale.governo.it) e dagli [Autori](AUTHORS.md).
+
+## A cosa serve questo file
+
+Molto software di qualità è stato sviluppato da diverse Pubbliche
+Amministrazioni ma i casi di riuso sono scarsi. Alcune tra le ragioni per la bassa
+adozione di tali progetti sono la difficoltà nel rilevarli così come la
+difficoltà nel capire se un dato progetto possa funzionare o meno nel contesto
+di una Pubblica Amministrazione differente. 
+
+Lo standard `publiccode.yml` ha lo scopo di risolvere queste problematiche.
+Infatti, si tratta di un semplice file che può essere letto facilmente sia dai
+dipendenti pubblici, che vogliono capire se possono usare o meno un dato
+software, che da un calcolatore.
+Lo standard contiene informazioni quali:
+* il titolo e la descrizione del progetto o prodotto in inglese e/o altre
+  lingue;
+* lo stato dello sviluppo ad es., `concept`, `development`, `beta`, `stable`,
+  `obsolete`;
+* quale organizzazione ha sviluppato il progetto;
+* chi si sta occupando della sua manutenzione e quando finirà;
+* chi contattare per domande di tipo tecnico o di supporto;
+* per quale quadro giuridico è stato pensato questo progetto o prodotto;
+* quali dipendenze software esistono. 
+
+Il formato del file `publiccode.yml` è pensato per essere facilmente aggiunto
+ad ogni nuovo progetto e potrà cambiare ed adattarsi ai cambiamenti rispetto al
+contesto nel quale è stato originariamente sviluppato. 
+
+## La ricerca dei progetti
+
+La ricerca dei progetti dipende da come le API sono state strutturate per ogni
+piattaforma di hosting. Ad esempio, per quanto riguarda la piattaforma GitHub,
+è possibile trovare tutti i progetti che adottano lo standard `publiccode.yml`
+attraverso l'interfaccia di frontend del portale oppure usando le API.
+
+* [Ricerca tramite GitHub `filename:publiccode.yml
+  path:/`](https://github.com/search?q=filename%3Apubliccode.yml+path%3A%2F)
+
+Il Team per la Trasformazione Digitale sta anche lavorando per fornire uno
+scanner che cerchi tutti i file `publiccode.yml` su tutti i siti accessibili
+pubblicamente, per poi pubblicarli sotto forma di open data. 
+
+## Come contribuire 
+
+Sentitevi liberi di aprire delle [Pull Requests e di presentare un problema
+con una Issues](CONTRIBUTING.md).
+
+## Licenza
+
+Il progetto è coperto da una licenza [CC-0](LICENSE).

README.md

@@ -40,7 +40,6 @@ The `publiccode.yml` file is meant to solve all those problems. As such, it is
 an easily readable file for civil servants that are trying to figure out
 whether a project will work for them, and easily readable for computers as
 well. It contains information such as:
-
 * the title and description of the project or product in English and/or other
   languages;
 * the development status, e.g. `concept`, `development`, `beta`, `stable`,
@@ -73,6 +72,13 @@ exposing them as open data.
 
 Feel free to submit [Pull Requests and to file Issues](CONTRIBUTING.md).
 
+This repository is structured in order to be compatible with the `Docs Italia`
+platform. As such, the markdown content in the relevant folders will be
+compiled and rendered on top of that platform. The `Docs Italia` platform is
+able to handle different releases and localised versions of the same file
+drawing from the document's GitHub repository. As such, the platform is to be
+considered the default landing page for the project.
+
 ## Licence
 
 Licenced under the [CC-0](LICENSE)

_docs/en/schema.md

@@ -1,9 +1,6 @@
-[< Back to version 0.1](index.html) -- this file is part of the [`publiccode.yml` specification](http://w3id.org/publiccode/).
-
 # The main schema
 
-This document the description of the schema of
-`publiccode.yml`.
+This document represents the description of the `publiccode.yml` schema.
 
 ## Structure
 
@@ -15,35 +12,38 @@ sense in specific countries, such as declaring compliance with local
 laws or regulations. The provided extension mechanism is the usage
 of country-specific sections.
 
-All country-specific sections are contained in a section named with the two-letter lowercase [ISO 3166-1 alpha-2 country code](https://it.wikipedia.org/wiki/ISO_3166-1_alpha-2).
-For instance `spid` is a property for Italian software declaring whether the software is integrated with the Italian Public Identification System.
+All country-specific extensions are contained in a section named with the
+two-letter lowercase [ISO 3166-1 alpha-2 country
+code](https://it.wikipedia.org/wiki/ISO_3166-1_alpha-2).
+For instance `spid` is a property for Italian software declaring whether the
+software is integrated with the Italian Public Identification System.
 
 If a software is compliant I will find:
 ```
 it:
   spid: yes
 ```
 
-Notice that country-specific keys within international sections are
-not allowed. Countries that want to extend the format should add one
-or many country-specific sections instead.
+Notice that country-specific extensions within international sections are
+not allowed. Countries that want to extend the format should add a
+country-specific section instead.
 
-Documentation for country specific sections is maintained in separate
-files.
+Documentation for the keys contained in a country specific section is
+maintained in separate files.
 
 * Italy: [Italian extensions](schema.it.md)
 
 
 ## Top-level section
 
-### Key `publiccode-yaml-version`
+### Key `publiccodeYmlVersion`
 
 * Type: string
 * Presence: mandatory
-* Example: `"http://w3id.org/publiccode/version/0.1"`
+* Example: `"0.1"`
 
 This key specifies the version to which the current `publiccode.yml`
-adheres to, for forward compatibility. Current version is `0.1`.
+adheres to, for forward compatibility. 
 
 ### Key `name`
 
@@ -108,7 +108,7 @@ specified repositories.
 ### Key `softwareVersion`
 
 * Type: string
-* Presence: mandatory
+* Presence: optional 
 * Example: `"1.0"`, `"dev"`
 
 This key contains the latest stable version number of the software.
@@ -131,12 +131,12 @@ and thus the version number is present.
 
 ### Key `logo`
 
-* Type: string (path to file)
+* Type: string (relative path to file or absolute URL)
 * Presence: optional
 * Acceptable formats: SVG, SVGZ, PNG
 * Example: `img/logo.svg`
 
-This key contains the logo of the software. Logos should be in vector
+This key contains the path to the logo of the software. Logos should be in vector
 format; raster formats are only allowed as a fallback. In this case, they should be transparent PNGs, minimum 1000px of
 width.
 
@@ -291,17 +291,17 @@ This section contains a general description of the software. Parsers
 can use this section for instance to create a web page describing
 the software.
 
-**Note** Since all the strings contained in this section are user-visible and written in a specific language, you **must** specify the language you are editing the text in (using [ISO 639-2](https://en.wikipedia.org/wiki/ISO_639-2) alpha-3 codes) by creating a section with that name.
+**Note** Since all the strings contained in this section are user-visible and written in a specific language, you **must** specify the language you are editing the text in (using [ISO 639-2](https://en.wikipedia.org/wiki/ISO_639-2) alpha-3 codes) by creating a sub-section with that name.
 
 An example for English:
-```.yaml
+```.yml
 description:
   eng:
     shortDescription: ...
     longDescription: ...
 ```
 
-In the following part of the document, all keys are assumed to be in a section with the name of the language (we will note this with `[lang]`).
+In the following part of the document, all keys are assumed to be in a sub-section with the name of the language (we will note this with `[lang]`).
 
 **Note:** It is mandatory to have *at least* one language in this section. All other languages are optional.
 
@@ -413,7 +413,7 @@ Each tag must be in Unicode lowercase, and should not contain
 any Unicode whitespace character. The suggested character to
 separate multiple words is `-` (single dash).
 
-### Key `description/[lang]/featureList`
+### Key `description/[lang]/features`
 
 * Type: array of strings
 * Presence: mandatory (for at least one language)
@@ -461,6 +461,9 @@ be hosted on a video sharing website that supports the
 [oEmbed](https://oembed.com) standard; popular options are YouTube and
 Vimeo.
 
+Since videos are an integral part of the documentation, it is recommended to
+publish them with an open license. 
+
 ### Key `description/[lang]/awards`
 
 * Type: array of strings
@@ -576,7 +579,8 @@ This section provides an overview of the localization features of the software.
 * Type: boolean
 * Presence: mandatory
 
-If `yes`, the software has infrastructure in place or is otherwise designed to be multilingual. It does not need to be available in more than one language.
+If `yes`, the software has infrastructure in place or is otherwise designed to
+be multilingual. It does not need to be available in more than one language.
 
 ## Key `localisation/availableLanguages`
 
@@ -585,8 +589,6 @@ If `yes`, the software has infrastructure in place or is otherwise designed to b
 
 If present, this is the list of languages in which the software is available. Of course, this list will contain at least one language.
 
-See also: https://en.wikipedia.org/wiki/ISO_639-2
-
 ### Section `dependsOn`
 
 This section provides an overview on the system-level dependencies
@@ -638,15 +640,15 @@ A `dependency` is a complex object. The properties are the following:
 It is of course possible to use the various keys to specify a complex compatibility matrix.
 
 *Ex. 1*
-```.yaml
+```.yml
 - name: PostgreSQL
   version: 3.2
   optional: yes
 ```
 This snippet marks an optional dependency on PostgreSQL exactly version 3.2.
 
 *Ex. 2*
-```.yaml
+```.yml
 - name: MySQL
   versionMin: 1.1
   versionMax: 1.3

document_settings.yml

@@ -1,8 +1,9 @@
 document:
-  name: publiccode.yml Standard 
+  name: Standard publiccode.yml
   description: |
-    This documentation contains the `publiccode.yml` standard. 
+    Questa è la documentazione relativa allo standard `publiccode.yml`.
   tags:
     - publiccode.yml 
     - standard 
-    - interoperability 
+    - interoperabilità
+    - riuso

index.it.md

@@ -0,0 +1,58 @@
+# Lo Standard `publiccode.yml`
+
+`publiccode.yml` è uno standard di descrizione di metadati ideato per essere
+inserito in repository contenenti software pubblici. Questo standard ha lo
+scopo di rendere il software sviluppato dalle Pubbliche Amministrazioni
+e Pubbliche Organizzazioni facile da individuare e, di conseguenza,
+riutilizzare. Proprio per questo motivo, è stato pensato per essere semplice da
+adottare sia per gli sviluppatori che per i non addetti ai lavori. 
+
+Nel corso degli anni, molto software di qualità è stato commissionato e/o
+sviluppato da diverse Pubbliche Amministrazioni, però i casi di riuso sono
+scarsi. Alcune tra le ragioni che hanno portato ad una bassa adozione di tali
+progetti sono state la difficoltà nel reperire informazioni riguardanti un dato
+progetto così come le perplessità nel capire se un dato progetto potesse essere
+adatto o meno nel contesto di una Pubblica Amministrazione diversa rispetto
+a quella che lo aveva originariamente commissionato. 
+
+Lo standard `publiccode.yml` si pone l'obiettivo di risolvere queste
+problematiche.  Si tratta, infatti, di un *singolo file* che può essere letto
+facilmente sia dai dipendenti pubblici, che vogliono capire se possono
+beneficiare dall'adozione di un dato software, che da un calcolatore
+elettronico.
+
+Tra le informazioni contenute in questo file vi sono:
+* il titolo e la descrizione del progetto o prodotto in inglese e/o altre
+  lingue;
+* lo stato dello sviluppo ad es., `concept`, `development`, `beta`, `stable`,
+  `obsolete`;
+* i riferimenti dell'organizzazione che ha sviluppato il progetto;
+* chi si sta occupando della sua manutenzione e quando il rapporto finirà;
+* chi contattare per domande di tipo tecnico o di supporto;
+* per quale quadro giuridico è stato pensato questo progetto o prodotto;
+* quali dipendenze software esistono.  e molte altre informazioni rilevanti. 
+
+Il formato del file `publiccode.yml` è pensato per essere rapidamente aggiunto
+ad ogni nuovo progetto e potrà crescere ed adattarsi ai cambiamenti di
+contesto. 
+
+In aggiunta, il *Team per la Trasformazione Digitale* sta lavorando per
+realizzare uno *scanner* in grado di cercare tutti i file `publiccode.yml`
+presenti all'interno dei repository di codice sorgente accessibili
+pubblicamente, per poi elencarli e pubblicarli sotto forma di open data. In tal
+modo, sarà dunque popolato il catalogo del riuso del software per la Pubblica
+Amministrazione.  
+Inoltre, il Team sta realizzando degli strumenti di supporto,
+come ad esempio un editor, che permettano di generare e/o validare un file
+`publiccode.yml` attraverso delle interfacce grafiche quindi facilitando anche
+il compito in fase di creazione. 
+
+.. toctree::
+   :maxdepth: 2
+
+   Schema dello standard <_docs/it/schema.md>
+   Estensioni italiane <_docs/it/schema.it.md>
+   Fork e Varianti <_docs/it/forks.md>
+   Tipi di Pubbliche Amministrazioni <_docs/it/pa-types.md>
+   Lista dei tag accettati <_docs/it/tags.md>
+   Strumenti di supporto <_docs/it/strumenti.md>