メインコンテンツまでスキップ

ドキュメント更新履歴 - PDF Connect v3

2026-02-21 手動URLブロックの更新​

  • 新しいガイドを追加: manual-url-blocks.md
  • 公開/セットアップ/ビューア/表示の各ドキュメントを更新し、手動の「商品テンプレートブロック」について記載
  • 「リンク済み」と「手動」の挙動の違いを明確化
  • 手動設定向けのトラブルシューティング項目を追加
  • 新ガイドを含むようにサイドバーのナビゲーションを更新

概要​

この更新履歴は、PDF Connect v3 のドキュメント全面改訂の進捗を追跡します。v3 では、すべてのページタイプに対するユニバーサルリンク、強化された公開ワークフロー、UI/UX の改善が導入されました。

ステータス凡例​

  • ✅ 完了 - v3 機能に合わせて更新済み（新しいスクリーンショット待ち）
  • 🔄 作業中 - 現在更新作業中
  • ❌ 要更新 - v3 に合わせた改修が必要な旧ファイル
  • 📸 スクリーンショット要 - 内容は更新済みで、新しい画像の追加待ち

更新済みファイル（v3）​

コアガイド - 完了 ✅​

intro-v3.md ✅​

  • ステータス: 完了（スクリーンショットが必要）
  • 変更点:
    • 3つの表示スタイル（埋め込みPDF、PDFボタン、PDFリスト）を説明する内容に更新
    • ユニバーサルリンク機能（全ページタイプ）を追加
    • シンプルな2ステップの公開ワークフローを強調
    • 成功事例とビジネス上の価値提案を追加
  • 旧ファイル: intro.md → intro-old.md
  • 必要なスクリーンショット: SCREENSHOT_REQUIREMENTS.md にて主要8枚を特定

tutorial-basics/link-pdfs-v3.md ✅​

  • ステータス: 完了（スクリーンショットが必要）
  • 変更点:
    • ユニバーサルリンク（全ページタイプ）に対応するため全面改稿
    • 検索、ページネーション、一括選択の機能を強化
    • ページ横断のリンク戦略とトラブルシューティングを追加
    • スクリーンショット用プレースホルダーを要所に配置
  • 旧ファイル: tutorial-basics/link-pdfs.md → tutorial-basics/link-pdfs-old.md
  • 必要なスクリーンショット: 主要12枚を特定

tutorial-basics/place-linked-pdf-v3.md ✅​

  • ステータス: 完了（スクリーンショットが必要）
  • 変更点:
    • 新しい公開モーダルシステムに合わせて更新
    • 3つの表示スタイルを、具体的なユースケース込みで追加
    • テンプレート選択と複数ブロック活用の戦略を強化
    • パフォーマンス最適化とトラブルシューティングの章を追加
  • 旧ファイル: tutorial-basics/place-linked-pdf.md → tutorial-basics/place-linked-pdf-old.md
  • 必要なスクリーンショット: 主要15枚を特定

publishing-workflow-v3.md ✅​

  • ステータス: 新規ファイル、完了（スクリーンショットが必要）
  • 目的: 新しい公開システムのための包括的なワークフローガイド
  • 内容:
    • 詳細なベストプラクティスとトラブルシューティング
    • テンプレート管理の戦略
    • パフォーマンスとUXの最適化
  • 必要なスクリーンショット: ワークフロー固有の主要8枚を特定

更新が必要なファイル ❌​

チュートリアル（基本）​

  • tutorial-basics/upload-a-pdf.md ❌ - v3 UIに合わせた更新が必要
  • tutorial-basics/account-and-subscription.md ❌ - 変更なしの可能性
  • tutorial-basics/paste-pdf-id.md ❌ - 旧機能の可能性
  • tutorial-basics/place-non-prd-page.md ❌ - ユニバーサルリンクで置き換え済み
  • tutorial-basics/place-linked-pdf-legacy.md ❌ - 旧方式（アーカイブ候補）

チュートリアル（追加）​

  • tutorial-extras/link-pdfs-bulk.md ❌ - v3 の一括UIに合わせた更新が必要
  • tutorial-extras/external-pdfs.md ❌ - v3 インターフェースに合わせた更新が必要
  • tutorial-extras/pdf-viewers.md ❌ - v3 のビューアオプションに合わせた更新が必要
  • tutorial-extras/using-tags.md ❌ - v3 のタグUIに合わせた更新が必要
  • tutorial-extras/translate-your-site.md ❌ - 変更なしの可能性

旧機能セクション​

  • legacy/button-designer.md ❌ - テーマエディタのブロックで置き換え済み
  • legacy/pdf-placement.md ❌ - 公開ワークフローで置き換え済み

スクリーンショット要件​

優先度1 - コアワークフロー 📸​

  1. アプリ概要: PDF管理のメイン画面
  2. リンク設定画面: 新しいページタイプのドロップダウンと選択操作
  3. 公開モーダル: 3つの表示スタイルの選択肢
  4. テーマエディタ: テンプレートへのPDFブロック追加
  5. リソース選択: 検索とページネーションの動作例

優先度2 - 高度な機能 📸​

  1. 複数ブロックのテンプレート: 同一ページに複数スタイルを配置した例
  2. 一括操作: スプレッドシート取り込みの画面
  3. 設定とカスタマイズ: ブロック設定のオプション
  4. モバイル表示: モバイル端末でのPDFの見え方
  5. パフォーマンスツール: 分析と最適化機能

優先度3 - ユースケース 📸​

  1. 商品マニュアル例: 商品ページへの埋め込みPDF
  2. コレクションカタログ: コレクションページ上のPDFリスト
  3. ブログの資料: 記事ページ上のPDFボタン
  4. ホームページの特集: インデックスページへのPDF統合
  5. エラーステート: 問題発生時にユーザーが目にする表示

撮影セッションのメモ​

撮影するUI要素​

  • 新しいドロップダウンメニューと選択UI
  • UXを改善したモーダル
  • テーマエディタへの統合ポイント
  • モバイルレスポンシブ表示
  • エラー表示と読み込み中の表示

用意するコンテンツ例​

  • 現実的な名称/説明のサンプルPDF
  • テスト用の商品、コレクション、記事、ページ
  • さまざまなPDFサイズとタイプ
  • モバイル端末でのテスト環境

Before/After 比較​

  • 旧リンクUI vs 新リンクUI
  • 旧配置（レガシー） vs テーマエディタのブロック
  • 商品のみ対応 vs ユニバーサルリンク
  • 単一の表示スタイル vs 複数の表示オプション

移行戦略​

フェーズ1: コアドキュメント ✅​

  • 主要ワークフローガイドを更新
  • 機能ドキュメントを包括的に作成
  • 新しいファイル命名規則を確立

フェーズ2: 詳細ガイド 🔄​

  • アップロード/アカウントのガイドを更新
  • 一括操作ドキュメントを改修
  • 外部PDF/ビューアのガイドを更新

フェーズ3: 旧機能の整理 📋​

  • 置き換え済み機能をアーカイブ
  • 既存ユーザー向け移行ガイドを作成
  • ナビゲーションと相互参照リンクを更新

フェーズ4: 視覚要素の強化 📸​

  • スクリーンショット撮影を調整
  • すべてのプレースホルダー画像を置き換え
  • 複雑なワークフロー向けの動画チュートリアルを追加
  • 実際のマーチャントでドキュメントを検証

ドキュメント改修の仕組み（実装済み） ✅​

ファイル管理方針​

  • 命名規則: 新ファイルは識別しやすいように -v3 接尾辞を使用
  • 旧ファイルの保持: 元ファイルは参照用に -old 接尾辞へリネーム
  • 変更の追跡: ステータス更新とスクリーンショット要件を含む更新履歴を整備

画像管理方針​

  • 旧画像の削除: 古いスクリーンショットをドキュメントから削除
  • 戦略的プレースホルダー: 視覚が有用な箇所に [SCREENSHOT NEEDED: Description] を配置
  • 要件のドキュメント化: 専用ファイルにスクリーンショット要件を整理
  • 優先度制度: 3段階の優先度で撮影対象を管理

品質保証プロセス​

  • 内容レビュー: v3 ファイルを正確性と網羅性の観点でレビュー
  • リンク検証: 内部リンクを v3 版へ更新
  • 一貫性チェック: 用語とフォーマットを全体で統一
  • アクセシビリティ: 代替テキスト要件と説明的プレースホルダーを計画

改修完了ファイル​

コアドキュメント ✅​

  1. intro-v3.md - v3 機能を含むメイン導入
  2. tutorial-basics/link-pdfs-v3.md - ユニバーサルリンクのガイド
  3. tutorial-basics/place-linked-pdf-v3.md - 強化された公開ガイド
  4. publishing-workflow-v3.md - 包括的なワークフローガイド

サポートドキュメント ✅​

  1. DOCUMENTATION_CHANGELOG.md - 変更追跡とステータス管理
  2. SCREENSHOT_REQUIREMENTS.md - ビジュアル計画

次フェーズのファイル（予定）​

  • getting-started-v3.md - モダンなオンボーディングガイド
  • advanced-features-v3.md - パワーユーザー向け機能
  • tutorial-basics/upload-a-pdf-v3.md - 更新されたアップロード手順
  • tutorial-extras/link-pdfs-bulk-v3.md - 強化された一括操作

この体系的な進め方により、以下を実現します:

  • コンテンツの損失ゼロ: すべての元コンテンツを保持
  • 進捗の見える化: 完了済み/要対応がひと目で分かる
  • プロ品質: 一貫性のある、現代的なドキュメント基準
  • 将来対応: 継続的な更新に耐えるスケーラブルな仕組み

成功指標​

ドキュメント品質:​

  • v3 の全機能を漏れなくドキュメント化
  • v2 から v3 への明確な移行手順
  • 新機能に関するサポート問い合わせの削減
  • わかりやすさに関するマーチャントの肯定的なフィードバック

視覚面の強化:​

  • 現在のUIを反映したモダンなスクリーンショット
  • すべてのガイドで一貫したビジュアル表現
  • モバイルに最適化されたドキュメント体験
  • 複雑なワークフロー向けの補足動画

この改修により、新しい PDF Connect v3 機能の品質と洗練度に見合うドキュメントを提供できるようになります。