Apple: Swift Doc Compiler supporta la scrittura di documentazione completa

Nell’ambito della Worldwide Developers Conference 2021 (WWDC21), Apple ha introdotto un nuovo compilatore di documentazione per i suoi framework di linguaggi di programmazione e pacchetti Swift. Swift-DocC è ora disponibile gratuitamente per gli sviluppatori e offre l’opportunità di scrivere documentazione estesa oltre al codice e creare siti Web di documentazione per le basi di codice Swift. Il compilatore supporta documenti API scritti come commenti di codice, articoli concettuali lunghi scritti in Markdown e tutorial con immagini incorporate.

Xcode 13 appare con Swift DocC

Secondo il post sul blog, Swift-DocC è incluso nella prossima tredicesima versione di Xcode ed è anche disponibile per le parti interessate come pacchetto open source. L’ambiente di sviluppo Apple è attualmente alla versione 12.5. Il nuovo compilatore deve essere in grado di integrarsi perfettamente nei flussi di lavoro esistenti ed essere compatibile con strumenti e ambienti di sviluppo comuni. Il complesso include strumenti e librerie progettati per aiutare gli sviluppatori a scrivere e creare documentazione su varie piattaforme (ad esempio Linux e macOS).

colui il quale doccLo strumento da riga di comando sembra essere già integrato in Xcode 13 e progettato per l’integrazione con altri sistemi di build come SwiftPM. Il progetto open source è costituito da diversi componenti, come il compilatore Swift-DocC, il visualizzatore Swift-DocC, le librerie Swift-Markdown e SymbolKit.

Crea facilmente documenti complessi

Secondo il post sul blog, l’obiettivo dello sviluppo era semplificare la creazione di un’ampia documentazione di riferimento. È inoltre possibile aggiungere nuovi tutorial per facilitare la comprensione dell’utilizzo dell’API su terze parti. Questi tutorial possono apparentemente essere incorporati nella documentazione esistente come gli articoli. Gli sviluppatori hanno anche la possibilità di collegare i propri documenti ad altri, unendoli in gruppi logici e introducendo collegamenti ad altri documenti.

Maggiori informazioni su Swift-DocC Può essere trovato nel blog ufficiale dell’Apple Programming Language.

(MDO)