Make it clear that the Windows ZIP download is portable (no installer, not in Apps & Features)
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 半日
- 初心者へのやさしさ
- 78/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- github-actions, html, markdown, yaml
- 領域
- documentation, release
調査の方向性
Windows リリースノートのテンプレートは .github/workflows/build.yml（Windows セクション）にあり、インストールとアンインストールのドキュメントは docs/installation.md と docs/Uninstalling-OpenSAK.md です。ユーザーガイドは site/user-guide.html で、site/index.html にはすでに "Portable ZIP" という表記があるため、文言の参照に使えます。完了の条件は、Issue 本文の文言を使った同じポータブル版の注記が、挙げられた各箇所に記載されていることと、アンインストールのドキュメントに %APPDATA%\opensak と Store 版の Documents\opensak フォルダーが明記されていることです。
索引モデルが issue の本文から書いたものです。
説明
A Windows user downloaded OpenSAK-…-Windows.zip from the Releases page and expected a normal installer. In particular, he expected:
the program to go into Program Files,
OpenSAK to show up in Apps & Features (and in uninstall tools such as Revo).
Neither happens, because the ZIP is portable. He concluded something had gone wrong and spent a long time trying to uninstall and reinstall. He also didn’t know that deleting the program folder leaves the settings in %APPDATA%\opensak (hidden by default). Those leftover settings were why the Welcome Wizard didn’t reappear.
The website does say “Portable ZIP” (site/index.html), but the GitHub release notes, which are where users actually download from, only say “Extract All → double-click OpenSAK.exe”. docs/installation.md mentions unzipping but never says the word “portable”.
Proposal
Add a short, consistent note wherever the Windows ZIP is offered:
Portable version: there is no installer. Unzip the folder anywhere you like (Program Files is not needed, and replacing files there requires admin rights). OpenSAK won’t appear in Apps & Features. To uninstall, delete the folder. Your settings and databases are kept in %APPDATA%\opensak (or the folders you chose in the Welcome Wizard). Help → OpenSAK File Locations… shows them all. For a regular install with automatic updates, use the Microsoft Store version.
Places to update:
Release notes template in .github/workflows/build.yml (Windows section)
docs/installation.md (Windows direct download section)
docs/Uninstalling-OpenSAK.md: delete the folder and how to find the data folders, including %APPDATA%\opensak and the Store version’s Documents\opensak
site/user-guide.html (installation section)
Optional: a README.txt inside the ZIP next to OpenSAK.exe with the same text
- 主要言語
- Python
- スター
- 37
- フォーク
- 17
- 平均マージ
- 21時間 5分
- マージ済み PR（30日）
- 131
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
OpenSAK-Org/OpenSAK のほかの issue
-
area: geo-data improvement
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
OpenSAK-Org/OpenSAK#1285 ·
メンテナーはふだん 1 日以内に返信
-
area: geo-data good first issue improvement
難易度 2/5 1〜3時間 初心者へのやさしさ 80/100
OpenSAK-Org/OpenSAK#789 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
area: UI improvement
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
OpenSAK-Org/OpenSAK#729 ·
メンテナーはふだん 1 日以内に返信
-
area: import improvement
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
OpenSAK-Org/OpenSAK#648 ·
メンテナーはふだん 1 日以内に返信
-
area: documentation improvement
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
OpenSAK-Org/OpenSAK#570 ·
メンテナーはふだん 1 日以内に返信
OpenSAK-Org/OpenSAK の issue をすべて見る
似ている issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 75/100
SACGF/variantgrid#2791 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
メンテナーはふだん 1 日以内に返信
-
bot-triaged oncall: cpu inductor
難易度 2/5 1〜3時間 初心者へのやさしさ 73/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
kubescape/cel-admission-library#141 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信