PDF教材の読みやすさを劇的に変えた3つの設計判断|MCP19台 完全実装ガイド v4 リリース
ヴィージェイ物産株式会社が販売しているPDF教材「Claude API + MCP 19台 完全実装ガイド」を v4 にアップデートしました。このバージョンアップは新しい技術を追加したわけではなく、「読みやすさ」だけのために構造を全面的に書き直したものです。読者の方から「コードがどこから始まるか分からない」「解説がどのコードを指しているか分からない」というご指摘を真摯に受け止め、購入後にスムーズに実装に取りかかれる教材を目指しました。本記事では、v3 から v4 への 3つの設計変更ポイントをそのまま公開します。教材を販売されている方、技術記事を書いている方の参考になれば幸いです。変更①:すべてのコードブロックに通し番号を振ったv3 では章ごとにコードが順序なく並んでいたため、「第4章のあのコード、もう一度見たい」となったときに探すのに手間がかかっていました。v4 では 122 個すべてのコードブロックに通し番号を付けました。第2章のコードは 2-1, 2-2, 2-3 ... 第4章のコードは 4-1, 4-2, 4-3 ... 付録Bのコードは B-1, B-2, B-3 ... というルールです。本文中で「コード例 4-7 を見てください」と相互参照できるようになり、章をまたいで読み返すストレスが消えました。技術書を書くときに「コード番号は当たり前」と思われがちですが、自己出版PDFだと意外と抜けがちです。v3 を読み返してみて、自分でも探すのに困ったのが導入のきっかけでした。変更②:解説を「コードの後ろ」に統一したv3 ではコードの前に長い解説があり、「読みながらコード
0