Xcode 9.1 のバグを踏んだ話（Playground コメントのレンダリング）

はじめに

• 弊社では Swift 言語を学ぶ研修用のコンテンツを、 Xcode Playground として用意しています
• Swift 4 に対応しようと思い、 Xcode 9.1 でコンテンツを開いてみました
• そこには、バグが潜んでいました…

本来の挙動

• Playground では、特別なコメントを記述することによりページ間のリンクやリッチな表現が可能となります¹

• 画像では「Render Documentation」がチェックされており、正しくレンダリングされているのがわかります

  

Xcode 9.1 のバグ

• ページを移動すると、「Render Documentation」がチェックされているにもかかわらず、コメントがレンダリングされていません

  

対策

• 現状、ページを移動するごとに「Render Documentation」のチェックを付け直すしかなさそうです²
• Apple も認識しているようなので、次のバージョンで修正されることを願うばかりです

---

1. Markup Formatting Reference: Markup Overview ↩

2. Intro to App Development Playgrounds not operating | Apple Developer Forums ↩