# How to run the docc/markdown tests on the Swift book (TSPL)?

**URL:** <https://forums.swift.org/t/how-to-run-the-docc-markdown-tests-on-the-swift-book-tspl/77240>\
**Category:** Swift-DocC\
**Tags:** swift-book, docc\
**Created:** [January 16, 2025, 3:25pm UTC](https://forums.swift.org/t/how-to-run-the-docc-markdown-tests-on-the-swift-book-tspl/77240 "2025-01-16T15:25:26Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Vinicius\_Vendramini](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/vinicius_vendramini/32/12370_2.png) [@Vinicius\_Vendramini](https://forums.swift.org/u/Vinicius_Vendramini)\
**Post date:** [January 16, 2025, 3:25pm UTC](https://forums.swift.org/t/how-to-run-the-docc-markdown-tests-on-the-swift-book-tspl/77240/1 "2025-01-16T15:25:26Z")

</div>

Hey yall, I've been exploring the [git repo](https://github.com/swiftlang/swift-book) for the Swift Programming Language book and noticed that there are some comments in the markdown files that look like a way to test the code snippets in the book using the Swift compiler. For example:

> <https://github.com/swiftlang/swift-book/blob/cc24ca402ef68b58e558ead229e6f4a3ff3c4167/TSPL.docc/GuidedTour/GuidedTour.md?plain=1#L19>

However, I didn't find a way to run these tests in the repo. Is that possible? Did I misunderstand the comments, or is it perhaps an internal Apple tool that wasn't included in the repo?

---

<div class="post-metadata">

**Author:** ![krilnon](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/krilnon/32/276_2.png) [@krilnon](https://forums.swift.org/u/krilnon)\
**Post date:** [January 17, 2025, 3:31am UTC](https://forums.swift.org/t/how-to-run-the-docc-markdown-tests-on-the-swift-book-tspl/77240/2 "2025-01-17T03:31:18Z")

</div>

Yep, those tests are from the older, RST-based pipeline we used to publish the book in the past. There isn’t a way to run them today, but we kept them in the book’s sources with the idea that there might be a way to bring them back later. Here’s the issue for that: [Restore tested code listings · Issue #5 · swiftlang/swift-book · GitHub](https://github.com/swiftlang/swift-book/issues/5)
