Port examples to new schema version (#26)

* fix: moved files into `docs` folder
* fix: typos and formatting
* fix: port examples to new schema version
* fix: moving to RST format, not needed anymore

Author: libremente

_docs/en/conf.py

@@ -0,0 +1,5 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+# The master toctree document.
+master_doc = 'index'

_docs/en/schema.it.md

@@ -1,8 +1,8 @@
-publiccode-yaml-version: "http://w3id.org/publiccode/version/0.1"
+publiccodeYmlVersion: "0.1"
 
 name: Medusa
 url: "https://example.com/italia/medusa.git"
-softwareVersion: "dev"
+softwareVersion: "dev"    # Optional
 releaseDate: "2017-04-15"
 platforms:
   - web
@@ -16,7 +16,7 @@ softwareType: "standalone"
 
 description:
   eng:
-    localisedName: Medusa
+    localisedName: medusa   # Optional
     genericName: Text Editor
     shortDescription: >
           A rather short description which
@@ -28,7 +28,7 @@ description:
           is and why one should need it. We can potentially
           have many pages of text here.
 
-    featureList:
+    features:
        - Just one feature
 
 legal:
@@ -43,4 +43,4 @@ maintenance:
 localisation:
   localisationReady: yes
   availableLanguages:
-    - eng
+    - eng

_docs/it/conf.py

@@ -1,4 +1,4 @@
-publiccode-yaml-version: "http://w3id.org/publiccode/version/0.1"
+publiccodeYmlVersion: "0.1"
 
 name: Medusa
 applicationSuite: MegaProductivitySuite
@@ -20,7 +20,6 @@ platforms:
   - android
   - ios
 
-# For a list of allowed values, check out w3id.org/publiccode/version/0.1/tags.html
 tags:
   - content-management
   - artificial-intelligence
@@ -67,7 +66,7 @@ description:
     freeTags:
        - an-english-tag
 
-    featureList:
+    features:
        - Very important feature
        - Will run without a problem
        - Has zero bugs
@@ -82,7 +81,7 @@ description:
        - 1st Price Software of the year
 
 legal:
-  license: AGPL-3.0-or-later        # SPDX expression of license
+  license: AGPL-3.0-or-later
   mainCopyrightOwner: City of Chicago
   repoOwner: City of Chicago
   authorsFile: AUTHORS
@@ -158,4 +157,4 @@ it:
     seo: no
     ui: yes
     web: yes
-    content: no
+    content: no

docs/en/conf.py

@@ -1,5 +1,3 @@
-[< Back to version 0.1](index.html) -- this file is part of the [`publiccode.yml` specification](http://w3id.org/publiccode/).
-
 # Forks and variants
 
 This document describes how to best handle software forks in the

_docs/it/example/publiccode.minimal.yml docs/en/example/publiccode.minimal.yml_docs/it/example/publiccode.minimal.yml renamed to docs/en/example/publiccode.minimal.yml

@@ -1,8 +1,7 @@
-# `publiccode.yml`: version 0.1
+# `publiccode.yml`
 
-This is the release of version 0.1 of the Public Code specification. Version 0.1 was released on the 20th June 2018.
-
-A PublicCode file written following this specification is guaranteed to remain compatible with all parsers implementing any 0.x release.
+A PublicCode file written following this specification is guaranteed to remain
+compatible with all parsers implementing any 0.x release.
 
 For more information on version numbering see [SemVer.org](https://semver.org/).
 

_docs/en/example/publiccode.yml docs/en/example/publiccode.yml_docs/en/example/publiccode.yml renamed to docs/en/example/publiccode.yml

@@ -1,5 +1,3 @@
-[< Back to version 0.1](index.html) -- this file is part of the [`publiccode.yml` specification](http://w3id.org/publiccode/).
-
 # Public administration types
 
 The key `intendedAudience/onlyFor` defines the types of public administration which is
@@ -56,18 +54,3 @@ Value | Description
 `it-afam` | Istituzioni per l'Alta Formazione Artistica, Musicale e Coreutica
 `school` | Istituti di Istruzione Statale di Ogni Ordine e Grado
 `university` | Università e Istituti di Istruzione Universitaria Pubblici
-
-<!--
-	>Unioni di Comuni e loro Consorzi e Associazioni
-	>Enti di Regolazione dei Servizi Idrici e o dei Rifiuti
-	Enti e Istituzioni di Ricerca Pubblici
-	Enti Pubblici Non Economici
-	Enti Pubblici Produttori di Servizi Assistenziali, Ricreativi e Culturali
-	>Federazioni Nazionali, Ordini, Collegi e Consigli Professionali
-	>Fondazioni Lirico, Sinfoniche
-	>Istituti Zooprofilattici Sperimentali
-	Organi Costituzionali e di Rilievo Costituzionale
-	>Parchi Nazionali, Consorzi e Enti Gestori di Parchi e Aree Naturali Protette
-
-	>Teatri Stabili ad Iniziativa Pubblica
--->

_docs/en/forks.md docs/en/forks.md_docs/en/forks.md renamed to docs/en/forks.md

@@ -0,0 +1,2 @@
+Placeholder for [schema.it.md](../it/schema.it.md).
+