説明と確認のための要点

文書を読み、ソフトについて説明するときに、用語の意味と確認できた範囲を整理するための補助資料です。

開発者、アプリの利用者、導入前に比較・評価する人を含め、公開文書を読む人・説明する人を対象とします。保存、注釈、ローカル処理といった語の意味を確かめ、事実、方針、既知の制約を区別して理解するために使えます。AIに調査を依頼した場合も、この資料を参照できます。

この資料は実装・変更の作業指示ではありません。開発者自身の判断と説明責任については開発の考え方を参照できます。ソフト自体の概要と配布物は README.md を、実際の操作手順や画面案内は利用者向け資料を参照してください。

英語版は Project overview reference を参照してください。

1. 説明の基礎

PDF Note Workspace は、WindowsでPDFを読み、原本を直接変更せずに注釈を付け、独立したノートと関連資料をローカルワークスペースで扱うためのアプリケーションである。

この資料でいうワークスペースは、PDF・注釈・ノート・関連資料を作業単位でまとめ、再開しやすくすることを目指すものである。「PDF編集」という語だけでは、PDF原本の変更、注釈の追加、注釈を含めた別PDFの出力の違いを表せないため、どの操作を指すかを区別する。設計思想と現在実装されている機能は混同しない。

資料を読むときも他の人へ説明するときも、目的に合わせて必要な資料を調べ、確認できた範囲を示す。公開資料で確認できない開発者の判断理由や実装状況は、未確認として扱う。

2. 主張を扱う際の注意

3. 確認事項

• 自分の作業に合うか: PDFを壊さず注釈を管理したいか、独立ノートと資料をワークスペースで扱いたいかを確認する。必要なら通常版・Lite版・読み取り専用ソフトの違いを案内する。
• 保存は安全か: 原本非破壊、stage、統合保存、バックアップ、復元を別々に説明する。問題時は削除や上書きより先に作業フォルダ全体のコピーを案内する。
• 通信しないか: これは配布方針として説明できる。対象版・配布物に通信機能がないという強い結論には、公開リポジトリまたは配布物の実体確認が必要である。
• 変換品質はどうか: 通常版のローカル変換は試験的で、フォントやレイアウトの差があり得るため、変換後のPDFを確認するよう案内する。
• OSSとは何か: ソースを確認でき、ライセンス条件の範囲で利用・学習・改変・再配布できるソフトウェアとして、無料と同義ではないことを説明する。本ソフトも、PDF処理のPDFium、Markdown解析のMD4C、通常版のOffice文書からPDFへの変換に使うLibreOfficeなどを利用している。利用したOSSとその用途は第三者通知、ライセンス文書の所在はライセンス整理表で確認できる。

4. GitHub Pagesで確認できる範囲

GitHub Pagesは公開文書ポータルであり、ここで読める introduction は背景・設計・確認のための資料である。一方、Pagesにはソース、テスト、設定、配布バイナリの実体を含めない。Pagesだけを読んだときは、公開文書で確認できる説明・方針と、追加確認が必要な実装状況を分ける。

5. 次に読む資料

1. 操作・導入は 使い方・セットアップ を読む。
2. 保存や復元は 保存と復元 を読む。
3. 配布物と基本方針は プロジェクト概要 を読む。
4. ライセンスは ライセンスと第三者通知 を読む。

EVIDENCE:

• README.md
• docs/ja/Using_the_App.md
• docs/ja/Save_and_Recovery.md
• docs/ja/Getting_Started.md
• docs/ja/Troubleshooting.md