diff --git a/KNOWN_ISSUES.md b/KNOWN_ISSUES.md new file mode 100644 index 0000000..0cdf530 --- /dev/null +++ b/KNOWN_ISSUES.md @@ -0,0 +1,100 @@ +# MyPocketOS Known Issues + +この文書は、MyPocketOS 初回リリース時点で確認されている制約・注意事項をまとめたものです。 + +## インストール + +### 正式サポートは「専用ディスクへの消去インストール」のみ + +Calamaresによる通常インストールでは、初回リリースの正式サポート範囲を +**インストール先ディスク全体を初期化する「ディスクの消去」方式**としています。 + +Calamares上に表示される以下の方式は、MyPocketOSでは十分な検証を行っていません。 + +- 既存OSとの共存インストール +- Dual Boot +- 既存OSの置き換え +- 手動パーティション設定 + +これらが必ず動作しないという意味ではありませんが、初回リリースでは正式サポート対象外です。 + +### インターネット接続が必要 + +Calamaresによる通常インストールにはインターネット接続が必要です。 + +Wi-Fiを使用する場合は、**Calamaresを起動する前にネットワークへ接続してください。** +Calamares起動後に接続しても、インターネット接続の要件表示が自動的に再評価されない場合があります。 + +### インストール要件 + +Calamaresによる通常インストールには、以下を目安とします。 + +- インストール先ストレージ: 16 GiB以上 +- RAM: 約2 GiB以上 + +## Persistence + +### Persistence領域は暗号化されない + +初回リリースのPersistence領域は暗号化されません。 + +Persistenceへ保存した `/home` のデータに加え、Wi-Fi設定を保持した場合は +NetworkManagerの接続情報も保存されます。 + +USBメモリを紛失・盗難された場合、保存内容を第三者に読み取られる可能性があります。 + +### 一部のPersistence経路・環境は未検証 + +初回リリースでは主要なPersistence経路を確認していますが、 +すべての組み合わせを検証しているわけではありません。 + +特に以下は検証範囲が限定されています。 + +- Secure Boot環境でのWi-Fi Persistence +- Mode AのUEFI / Secure Boot実機 +- 複数Wi-Fiプロファイル +- 複数機種・複数ファームウェアでの動作 + +## 起動・終了時の表示 + +### shutdown時に警告が表示される場合がある + +Live環境の終了時に、以下のようなメッセージが表示される場合があります。 + +- `Device or resource busy` +- `Could not detach loopback` +- watchdog関連の警告 + +確認済みの環境では、USB取り外し案内、再起動、インストール後のシステム起動に +実害は確認されていません。 + +## ハードウェア互換性 + +### 一部のIntel内蔵グラフィックス環境で表示乱れが発生する場合がある + +確認した一部のIntel内蔵グラフィックス搭載機では、通常起動時に +縦線などの表示乱れが発生する場合があります。 + +この現象をすべてのIntel GPU環境へ一般化するものではありません。 +回避策としてカーネルパラメータの追加が必要になる場合があります。 + +## その他 + +### jgmenuの日本語検索には制約がある + +jgmenuの検索では、日本語入力・検索の挙動に制約が見られる場合があります。 + +### タイムゾーンのGeoIP自動選択には非対応 + +初回リリースでは、GeoIPによるタイムゾーンの自動選択には対応していません。 +既定値は `Asia/Tokyo` です。 + +### 一部環境でjournaldのWATCHDOG警告が表示される場合がある + +一部の終了処理等でWATCHDOG関連の警告が表示される場合があります。 +現時点では、通常利用への実害は確認されていません。 + +--- + +確認範囲は初回リリース時点のものです。 +ハードウェアやファームウェアの組み合わせによって、結果が異なる場合があります。 diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md new file mode 100644 index 0000000..fe3b7b8 --- /dev/null +++ b/RELEASE_NOTES.md @@ -0,0 +1,103 @@ +# MyPocketOS Release Notes + +## Initial Release + +MyPocketOSは、Debian 13をベースにした軽量なデスクトップLinuxです。 + +USBメモリから起動して使えるLive環境と、必要に応じて内蔵ストレージへ +インストールして利用できる構成を目指しています。 + +## 主な特徴 + +- Debian 13 ベース +- Openbox + tint2 + jgmenuによる軽量デスクトップ +- 日本語表示・日本語入力対応 +- IBus / Mozc対応 +- CalamaresによるGUIインストール +- USB Live起動 +- `/home` を中心としたPersistence対応 +- Wi-Fi設定のPersistence対応 +- Flatpak標準搭載 +- Base版 / Standard版の2エディション +- MyPocketOS独自ブランディング +- UEFI / Legacy BIOS起動対応 +- Secure Boot環境での起動確認済み + +## エディション + +### Base + +必要最低限のデスクトップ環境を中心に構成した軽量版です。 + +### Standard + +Base版をベースに、日常利用向けのアプリケーションや機能を追加した標準版です。 + +## インストール + +CalamaresによるGUIインストーラーを搭載しています。 + +初回リリースで正式にサポートするのは、 +**インストール先ディスク全体を使用する「ディスクの消去」方式**です。 + +通常インストールには、以下が必要です。 + +- インターネット接続 +- 16 GiB以上のインストール先ストレージ +- 約2 GiB以上のRAM + +## Persistence + +USBメモリ上にPersistence領域を作成することで、 +Live環境でもユーザーデータや設定を保持できます。 + +初回リリースでは主に以下を保持対象とします。 + +- `/home` +- ユーザー設定 +- Wi-Fi接続設定 + +追加アプリについては、Persistenceとの相性を考慮し、 +`flatpak --user` の利用を推奨します。 + +## 推奨USB容量 + +- 最小目安: 16GB +- 推奨: 32GB以上 + +## 検証状況 + +初回リリースに向け、以下の確認を実施しています。 + +- Virtual Machine上でのLive起動 +- Standard版のCalamaresインストール +- Legacy BIOS実機での起動・インストール +- UEFI実機での起動・インストール +- Secure Boot有効環境での起動 +- Persistence基本動作 +- 日本語入力 +- Wi-Fi +- サウンド +- タッチパッド +- バッテリー表示 +- Openbox / tint2 / jgmenuデスクトップ + +ハードウェアやファームウェアの組み合わせによっては、 +追加の設定が必要になる場合があります。 + +## 既知の問題 + +既知の制約・注意事項については `KNOWN_ISSUES.md` を参照してください。 + +## ライセンス + +MyPocketOSのプロジェクトコードはGNU General Public License Version 3 +(GPLv3)のもとで公開しています。 + +同梱しているソフトウェアやアセットには、それぞれ個別のライセンスが適用される場合があります。 +詳細は `THIRD_PARTY_NOTICES.md` を参照してください。 + +## ISO / SHA-256 + +初回リリースで公開するBase版・Standard版の最終ISOサイズおよびSHA-256は、 +リリース用確定コミットから最終ビルドを行った後に記録します。 diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md new file mode 100644 index 0000000..645f571 --- /dev/null +++ b/THIRD_PARTY_NOTICES.md @@ -0,0 +1,51 @@ +# Third-Party Notices + +MyPocketOSには、第三者が開発・公開しているソフトウェア、ライブラリ、 +アイコンテーマ、その他のアセットが含まれています。 + +それぞれのコンポーネントには、各プロジェクトが定めるライセンス条件が適用されます。 +MyPocketOS全体の `LICENSE` が、これら第三者コンポーネントの個別ライセンスを +上書きするものではありません。 + +## MyPocketOS-Fluent-yellow icon theme + +MyPocketOSで使用する `MyPocketOS-Fluent-yellow` アイコンテーマには、 +同梱アーカイブ内の `COPYING` にGNU General Public License Version 3 +(GPLv3)が含まれています。 + +ライセンス文書は以下に同梱されています。 + +`config/includes.chroot/usr/share/mypocketos/icon-themes/MyPocketOS-Fluent-yellow.tar.gz` + +アーカイブ内: + +`MyPocketOS-Fluent-yellow/COPYING` + +## Debian packages and bundled software + +MyPocketOSはDebian 13をベースとしており、多数のDebianパッケージおよび +オープンソースソフトウェアを利用しています。 + +これらのパッケージには、それぞれ個別のライセンスが適用されます。 +インストール済みシステムでは、各パッケージのライセンス情報を通常 +`/usr/share/doc//copyright` +などから確認できます。 + +主なコンポーネントには、以下が含まれます。 + +- Debian GNU/Linux +- Linux kernel +- Openbox +- tint2 +- jgmenu +- PCManFM +- Calamares +- Flatpak +- IBus +- Mozc +- NetworkManager + +上記は主要コンポーネントの例であり、完全な一覧ではありません。 + +各ソフトウェアの著作権およびライセンス条件については、 +それぞれの配布元および同梱ライセンス文書を参照してください。