Apple: Swift-Doc-Compiler unterstützt beim Schreiben umfassender Dokumentationen
Das Open-Source-Projekt für Apples Programmiersprache Swift soll bereits in der kommenden Xcode-Version 13 enthalten sein.
Im Rahmen der Worldwide Developers Conference 2021 (WWDC21) hat Apple einen neuen Documentation Compiler für Frameworks und Packages der eigenen Programmiersprache Swift vorgestellt. Swift-DocC steht Entwicklerinnen und Entwicklern und nun frei zur Verfügung und bietet die Möglichkeit, umfangreiche Dokumentationen neben dem Code zu verfassen und Dokumentations-Webseiten für Swift-Codebases zu erstellen. Der Compiler unterstützt API-Dokumente, die als Code-Kommentare verfasst wurden, lange konzeptionelle Artikel, die in Markdown geschrieben sind sowie Tutorials mit integrierten Bildern.
Xcode 13 erscheint mit Swift-DocC
Swift-DocC ist laut Blogbeitrag in der kommenden Xcode-Version 13 enthalten und steht Interessierten zudem als Open-Source-Paket zur Verfügung. Aktuell liegt Apples Entwicklungsumgebung in Version 12.5 vor. Der neue Compiler soll sich nahtlos in bestehende Workflows integrieren lassen und mit gängigen Tools und Entwicklungsumgebungen kompatibel sein. Der Compiler umfasst Werkzeuge und Bibliotheken, die Entwicklern beim Schreiben und Generieren von Dokumentationen auf verschiedenen Plattformen (z. B. Linux und macOS) unterstützten sollen.
Das docc
-Befehlszeilentool ist offenbar bereits in Xcode 13 integriert und darauf ausgelegt, dass es sich in andere Build-Systeme wie SwiftPM integrieren lässt. Das Open-Source-Projekt besteht aus mehreren Komponenten, wie dem Compiler-Tool Swift-DocC, dem Swift-DocC-Renderer und den Bibliotheken Swift-Markdown und SymbolKit.
- Vor WWDC 2021: Entwickler verärgert von Apples App-Store-Verteidigung
- iOS 15, macOS 12 und MacBooks: Was wir von Apples WWDC-Keynote 2021 erwarten
- Apples WWDC-Keynote 2021 im Liveticker: iOS 15, macOS 12 und mehr
- Ab 19 Uhr: iOS 15, macOS 12 und mehr im Liveticker und Live-Kommentar zur WWDC
- iOS 15 und iPadOS 15: FaceTime öffnet sich für Android und Windows
- macOS 12 bekommt Kurzbefehle und erleichtert Datenaustausch
- Apple startet Cloud-Dienst für Continuous Integration über Xcode
- Allgemeine Übersicht zur WWDC21
Komplexe Dokumentationen einfach erstellen
Ziel der Entwicklung war gemäß Blogbeitrag, das Erstellen umfangreicher Referenzdokumentationen zu vereinfachen. Auch das Hinzufügen neuer Tutorials ist möglich, die Drittanbietern die Verwendung einer API verständlicher machen sollen. Diese Tutorials lassen sich offenbar wie Artikel in bestehende Dokumentationen einbinden. Entwicklerinnen und Entwickler haben zudem die Möglichkeit, eigene Dokumentation mit anderen zu verknüpfen, sie in logische Gruppen einzugliedern und Links zu anderen Dokumenten einzufügen.
Nähere Informationen zu Swift-DocC finden sich im offiziellen Blog zu Apples Programmiersprache.
(mdo)