Benvenuto nella WikiTech di Democom.
Questa piattaforma rappresenta il punto di riferimento tecnico ufficiale dell’azienda.
Qui vengono raccolte, organizzate e mantenute tutte le informazioni relative ai progetti, all’infrastruttura, alle applicazioni, alle procedure operative e ai percorsi di apprendimento adottati in Democom.
La WikiTech non è un archivio informale né un insieme di appunti sparsi:
è una base di conoscenza strutturata, pensata per durare nel tempo e per essere comprensibile, utilizzabile e replicabile.
La WikiTech di Democom nasce con l’obiettivo di:
- Centralizzare la conoscenza tecnica aziendale
- Documentare come e perché vengono fatte determinate scelte
- Rendere i sistemi comprensibili anche a chi non li ha progettati
- Favorire onboarding, manutenzione e continuità operativa
- Supportare il learning by doing tramite guide pratiche e sequenziali
- Ridurre la dipendenza dalla conoscenza individuale
Tutto ciò che è rilevante a livello tecnico deve trovare posto qui.
Questa wiki è basata su Wiki.js, deployato come microservizio tramite Helm all’interno dell’infrastruttura aziendale.
Rispetto alle Wiki tradizionali (ad esempio GitHub o GitLab), questa soluzione offre:
- Un’organizzazione gerarchica e annidata dei contenuti
- Navigazione chiara e strutturata per ambiti
- Supporto nativo e completo al Markdown
- Maggiore leggibilità e fruibilità dei contenuti tecnici
- Separazione netta tra codice e documentazione
- Un’esperienza pensata specificamente per la documentazione tecnica
Il Markdown consente di:
- leggere rapidamente
- copiare ed eseguire comandi
- comprendere configurazioni reali
- applicare esempi senza ambiguità
La documentazione è organizzata per percorsi logici, non per file fisici.
Le principali aree che verranno sviluppate includono:
-
Progetti
- Documentazione tecnica delle applicazioni
- Architettura, flussi e integrazioni
- Scelte progettuali e loro motivazioni
-
Infrastruttura
- Kubernetes
- Helm
- Networking, DNS, certificati
- CI/CD e processi di deploy
-
Applicazioni
- Servizi interni
- Microservizi
- Configurazioni e dipendenze
-
Procedure operative
- Runbook
- Manutenzione
- Troubleshooting
- Operazioni ricorrenti
-
Guide di apprendimento
- Percorsi introduttivi
- Guide passo-passo
- Materiale formativo interno
Ogni sezione può essere ulteriormente articolata in sotto-sezioni, mantenendo una struttura chiara e coerente.
La WikiTech è pensata per:
- Sviluppatori
- DevOps
- Tecnici
- Nuovi ingressi
- Chiunque debba comprendere, usare o manutenere i sistemi Democom
Non si assume conoscenza pregressa:
ogni documento deve spiegare ciò che fa e il motivo per cui lo fa.
- Documentare in modo chiaro e concreto
- Evitare informazioni implicite o date per scontate
- Preferire spiegazioni progressive e pratiche
- Usare il Markdown in modo leggibile e coerente
- Documentare anche le decisioni, non solo i comandi
- Scrivere pensando a chi leggerà questa pagina in futuro
La WikiTech di Democom è una fonte di verità tecnica.
Se qualcosa non è documentato qui, non è ufficialmente conosciuto.
Questo spazio cresce insieme ai progetti e alle persone che lo utilizzano.