更新: 此博文中的信息已被我们的官方文档取代。请参考该文档,而不是这篇博文。
两个月前,我们推出了自动生成、自动托管和自动更新 DocC 文档,今天我们再次带来更多以文档为中心的新闻!
对于包作者来说,选择加入此功能非常简单,只需快速修改包的 .spi.yml
文件,告诉我们用于文档生成过程的目标/平台即可。剩下的事情都由我们处理,并且每个选择加入的包都会自动显示“Documentation(文档)”链接。
我们很高兴地说,此功能非常成功,现在已有超过一百个包选择在我们这里托管文档。这太棒了!
今天,对于这 103 位包作者,我们有一些好消息要宣布。你们做出了正确的选择,因为你们现在也自动获得了版本化文档!
我们最初为包的默认分支生成文档。这是我们构建该功能的最简单方法,也是一个良好的开端,但版本化文档才是我们的目标。
当您使用一个包时,通常会使用最新的标记版本,因此我们应该默认显示从该版本生成的文档。从今天开始,情况就是这样了。

我们将继续为默认分支生成文档,并且随着包的演变,我们将为每个主要版本保留存档文档。将鼠标悬停在版本上即可切换到不同版本或默认分支的文档

我们还移动了为一个包生成多个文档存档的包的选择器

为什么不使用其中一个已记录的包来查看此功能呢?按字母顺序,您可以从 AdvancedList、AgoraUIKit_iOS、AnimationPlanner、AnyAsyncSequence、AnyLint、AnyMeasure、apnswift、AppFoundation、AppStorage、Boutique、Buildkite、bytes、CalendarKit、CameraControlARView、CertificateSigningRequest、CombineCoreBluetooth、composable-effect-identifier、Compute、ConcurrencyPlus、CryptoSwift、CurrencyConverter、CustomRepeatDate、DesignReviewer、Dflat、EffectsLibrary、Epoxy、FileSystemEventPublisher、FocusEntity、GatheredKit、GeoJSONKit、gis-tools、HandySwift、HandyUIKit、KeyboardShortcuts、KeyboardToolbar、Kingfisher、LeftPad、Lindenmayer、LocationFormatter、Lottie、Media、MeshGenerator、Microya、MonthYearWheelPicker、mqtt-nio、MuJoCo、mvt-tools、NetworkReachability、OperationPlus、ParseSwift、PianoRoll、Pioneer、postgres-nio、Pretty、PrettyLog、reactiveswift-composable-architecture、RevenueCat、Runestone、Saga、ScaledFont、SceneKitDebugTools、Script.swift、secp256k1、SemanticVersion、SemanticVersioningKit、Server、SGPKit、SmoothGradient、SpanGrid、Squirrel3、Steam、StoreFlowable、StreamChat、StreamChatSwiftUI、StreamChatVapor、Stytch、swift-bundler、swift-case-paths、swift-composable-architecture、swift-confidential、swift-markdown、swift-multipart-formdata、swift-parsing、swift-url-routing、swift-xml-parser、SwiftDocC、SwiftInspector、SwiftPlantUML、SwiftProtobuf、swiftui-cached-async-image、SwiftUICharts、SwiftUnits、SwiftVizScale、SwiftyProvisioningProfile、TGCardViewController、UnsplashFramework、Updeto、URLCompatibilityKit、vapor-routing、WeakReference、XCSnippets、Yams 或 YMatterType! 哎唷! 😅
我们希望大家喜欢这个功能,如果您想为您的包生成文档,请参考启动博文中的说明。