feat: merge pull request #38 from italia/feat/update_guide

Update guide
italia · Mar 25, 2022 · f29b522 · f29b522 · vercel · Mar 25, 2022
2 parents 109e541 + b6eb78f
commit f29b522
Show file tree

Hide file tree

Showing 59 changed files with 1,904 additions and 1,671 deletions.
diff --git a/Dockerfile b/Dockerfile
@@ -1,4 +1,4 @@
-FROM python:3.8
+FROM python:3.9
 
 WORKDIR /app
 

diff --git a/amministratori-pubblici.rst b/amministratori-pubblici.rst
diff --git a/...nistratori-pubblici/contribuire-al-software-open-source-sviluppato-da-altri.rst b/...nistratori-pubblici/contribuire-al-software-open-source-sviluppato-da-altri.rst
diff --git a/amministratori-pubblici/gestire-un-software-nel-suo-ciclo-di-vita.rst b/amministratori-pubblici/gestire-un-software-nel-suo-ciclo-di-vita.rst
diff --git a/amministratori-pubblici/i-vantaggi-del-modello-open-source.rst b/amministratori-pubblici/i-vantaggi-del-modello-open-source.rst
diff --git a/bibliografia-sitografia.rst b/bibliografia-sitografia.rst
@@ -0,0 +1,18 @@
+Bibliografia / Sitografia
+=========================
+
+Di seguito alcuni riferimenti utili sui quali approfondire queste
+tematiche
+
+-  Standard for Public Code: https://standard.publiccode.net/
+
+-  Google Open Source: https://opensource.google/docs/
+
+-  GitHub Guides: https://guides.github.com/
+
+-  GitLab Guides:
+   `https://docs.gitlab.com/ce/gitlab-basics/ <https://docs.gitlab.com/ee/gitlab-basics/>`__
+
+-  12 Factor App: https://12factor.net/it/
+
+.. _section-1:
diff --git a/conf.py b/conf.py
diff --git a/docker-compose.yml b/docker-compose.yml
@@ -3,15 +3,8 @@ services:
   web:
     build: .
     volumes:
-      - ./index.rst:/app/index.rst
-      - ./media:/app/media
-      - ./introduzione:/app/introduzione
-      - ./introduzione.rst:/app/introduzione.rst
-      - ./responsabili-politici:/app/responsabili-politici
-      - ./responsabili-politici.rst:/app/responsabili-politici.rst
-      - ./sviluppatori:/app/sviluppatori
-      - ./sviluppatori.rst:/app/sviluppatori.rst
-      - ./amministratori-pubblici:/app/amministratori-pubblici
-      - ./amministratori-pubblici.rst:/app/amministratori-pubblici.rst
+      - .:/app
+      - /app/preview_build/
+      - ./preview_build/preview_configuration.py:/app/conf.py
     ports:
       - "8000:8000"
diff --git a/index.rst b/index.rst
@@ -1,25 +1,24 @@
-#################################################
 Guida allo sviluppo e gestione di software libero
-#################################################
-
+=================================================
 
 .. highlights ::
 
-  **Buone pratiche, suggerimenti e tecniche utili allo sviluppo di software
-  open source per chi gestisce, progetta e realizza i servizi pubblici digitali
-  italiani**
+  **Buone pratiche, suggerimenti e tecniche utili allo sviluppo di
+  software open source per chi progetta, realizza e gestisce i servizi
+  pubblici digitali italiani.**
 
-Questo documento si pone l’obiettivo di fornire alla community Developers
-Italia delle buone pratiche di gestione di progetti  e indicare strumenti che
-possono essere utilizzati nello sviluppo di software open source.
+Questo documento si pone l’obiettivo di fornire agli attori della
+trasformazione digitale delle buone pratiche di gestione di progetti e
+indicare strumenti che possono essere utilizzati nello sviluppo di
+software open source.
 
 .. toctree::
 	:maxdepth: 3
 	:caption: Indice dei contenuti
-	:numbered:
 
   introduzione.rst
-  responsabili-politici.rst
-  amministratori-pubblici.rst
-  sviluppatori.rst
+  per-le-responsabili-politiche-e-i-responsabili-politici.rst
+  per-gli-amministratori-pubblici.rst
+  per-chi-sviluppa-il-software.rst
+  bibliografia-sitografia.rst