Documentation Tooling Workgroup Meeting - Jan 26th, 2026

Documentation Tooling Workgroup - 26 January 2026

Topics

  • Swift Docs Sync (open source)
    • Docs Repo created (private for now)
  • Next steps on versioning support for versioned DocC content on Swift.org

Attending

  • Joe Heck
  • Vera Mitchell
  • Sven Schmidt
  • Dave Verwer
  • Franklin Schrans
  • David Ronnqvist

Discussion

  • Franklin: Updated workgroup org membership: removed Kyle, Dianna, and Daniel in update

  • Joe: Had a swift docs sync - Swift StdLib had an author reset, is still progressing

    • Versioning is layering over it, Jerimiah is prototyping it, has upcoming feedback needs for version navigation/selection, will report back when I get the details.
  • Joe: Also a question - what inspired the amazing JSON parsing PR?

  • Implement a fast custom decoder for symbol graph JSON files by d-ronnqvist · Pull Request #1420 · swiftlang/swift-docc · GitHub

    • 10% faster decoding for JSON decoding of Symbolgraphs
    • new decoding mechanisms using SPAN
  • Dave: When in Foundation?

  • Vera: This is getting wins by being super specific to what it's expecting

  • David: Reads by chunks through a raw buffer array and progresses into the JSON without lots of allocations or re-reads.

  • Joe: Really curious - what's the gap with what you did and what Span offers now

  • David: The loading mechanism that's being pitched in the forums right now is one of the biggest things.

  • (Joe): I think this is the pitch referenced: [Pitch 2] Safe loading of values from `RawSpan`

  • David: Holding for the 6.3 initial release for SEO release

  • Franklin: The Markdown file generation was also cherry picked into 6.3

  • Joe: Are there docs expected with this, or is it more experimental and left as is?

  • Franklin: worth exploring in original thread on Forums

Action Items

  • none
1 Like

A small correction (that I don’t know how much it matters):

JSON decoding of symbol graph files is 10 times faster. This makes the documentation build 10% faster.

2 Likes