Documentazione

Panoramica

Panoramica

Benvenuto nella sezione Getting Started della Documentazione di BlackTrails. Qui troverai i passi essenziali per comprendere come funziona la nostra documentazione e come navigare attraverso la filosofia e le fondamenta tecniche del progetto.

L'obiettivo di questa sezione è darti un orientamento chiaro:

  • Struttura → come la documentazione è organizzata in cartelle, meta.json e file .mdx.
  • Localizzazione → come gestire contenuti multilingua (IT/EN).
  • Principi → dove trovare i documenti fondamentali come i 10 Principi Fondamentali.
  • Guide Tecniche → contenuti futuri per supportare sviluppo e integrazioni.

Come funziona

Ogni pagina in questa sezione corrisponde a un file .mdx che si trova sotto content/docs/getting-started/. La sidebar viene generata automaticamente da meta.json, che definisce l'ordine e il titolo delle pagine.

Questo garantisce che la Documentazione di BlackTrails sia:

  • Coerente – stesso stile e navigazione in tutte le sezioni.
  • Flessibile – facile da espandere con nuove pagine e traduzioni.
  • Trasparente – tutti possono leggere, verificare e contribuire.

Prossimi passi

Dopo questa panoramica, puoi approfondire la sezione Vision per esplorare i 10 Principi Fondamentali che guidano BlackTrails. Oppure continua seguendo le guide tecniche per vedere come filosofia e tecnologia lavorano insieme.

Panoramica | Documentazione | BlackTrails