Benvenuto nella Documentazione di IN-1

Qui troverai tutto ciò che ti serve per comprendere e lavorare con IN-1: la nostra filosofia, i principi fondamentali che guidano la comunità e la logica che sostiene il nostro ecosistema tecnologico.

La documentazione è organizzata in sezioni, ognuna rappresentata da una cartella sotto content/docs/. Ogni sezione ha il proprio meta.json, che ne definisce il titolo, l'ordine nella sidebar e l'elenco dei file .mdx inclusi. Ogni file .mdx ha un frontmatter (title, description) che controlla come appare nella navigazione.

In questo modo, la documentazione è:

• Modulare → aggiungi o rimuovi sezioni senza rompere la struttura.
• Localizzata → ogni .mdx può avere .it.mdx, .en.mdx, ecc.
• Coerente → sidebar e routing sono generati automaticamente dal contenuto.

Struttura della documentazione

La documentazione pubblica è divisa in sezioni come:

• Getting Started → orientamento, come iniziare, basi tecniche.
• Vision → i 10 Principi Fondamentali e le nostre fondamenta filosofiche.
• Approfondimenti → articoli, riflessioni e materiali sulla visione profonda di IN-1.
• Sezioni future → dedicate a funzionalità, roadmap e integrazioni.

Ogni sezione vive all'interno della propria cartella, per esempio:

content/docs/
  meta.json            # indice root
  index.mdx            # landing page (questo file)
  getting-started/
    meta.json
    overview.mdx
  vision/
    meta.json
    core-principle.mdx
  approfondimenti/
    meta.json
    index.mdx
    algoritmo.mdx
    sviluppo-cognitivo.mdx

Esempio di codice

Qui sotto un semplice esempio in Python, mostrato per illustrare l'evidenziazione del codice all'interno delle pagine di documentazione:

def ciao_in1():
    print("Benvenuto nella Documentazione di IN-1!")

Immagini

Le pagine della documentazione supportano immagini con zoom e rendering responsivo. Per esempio, l'immagine qui sotto dimostra il layout della documentazione di IN-1:

Liste

Questo è un esempio di come vengono renderizzate le liste:

• Organizzazione chiara e modulare
• Supporto multilingua (IT/EN/…)
• Generazione automatica della sidebar

Filosofia dietro la documentazione

Per IN-1, la documentazione non è solo un manuale: è parte della nostra trasparenza e del nostro approccio comunitario.

Aprendo i nostri principi, la nostra logica di sviluppo e la nostra organizzazione del codice, rendiamo il progetto accessibile e verificabile da tutti.

La documentazione è:

• Una riferimento tecnico per chi costruisce con noi,
• Una guida filosofica per chi vuole comprendere la visione che sostiene IN-1.