From 6073a039671446a77c0144aa6930a64a832664a0 Mon Sep 17 00:00:00 2001
From: syuilo <Syuilotan@yahoo.co.jp>
Date: Fri, 6 Aug 2021 00:33:25 +0900
Subject: [PATCH] Improve docs

---
 src/docs/ja-JP/general/faq.md             |  8 ++++++++
 src/docs/ja-JP/general/report-issue.md    | 10 ++++++++++
 src/docs/ja-JP/general/troubleshooting.md |  8 ++++++++
 3 files changed, 26 insertions(+)
 create mode 100644 src/docs/ja-JP/general/report-issue.md

diff --git a/src/docs/ja-JP/general/faq.md b/src/docs/ja-JP/general/faq.md
index d956039c12..86180e04bc 100644
--- a/src/docs/ja-JP/general/faq.md
+++ b/src/docs/ja-JP/general/faq.md
@@ -2,6 +2,14 @@
 ここでは利用上のよくある質問について掲載しています。
 Misskeyのプロジェクト自体についてのよくある質問は[こちら](./misskey)に掲載されています。
 
+### iOS/Androidのアプリはありますか?
+公式にはそういったOSのネイティブアプリを開発していませんが、サードパーティ製のアプリがいくつかあります。
+詳しくは[こちら](./apps)をご覧ください。
+
+ただ、サードパーティ製アプリはどうしても機能への対応が遅れてしまうため、とくに拘りがなければ公式のWebクライアントの利用をおすすめします。
+なお、MisskeyのWebクライアントはPWAに対応しているので、ネイティブアプリのように動作させることも可能です。
+詳しくは[こちら](todo)をご覧ください。
+
 ## 他のサーバーのユーザーをフォローするときは?
 メニューから検索を選び、ユーザー名をホスト込みで入力します。例: `@syuilo@misskey.io`
 
diff --git a/src/docs/ja-JP/general/report-issue.md b/src/docs/ja-JP/general/report-issue.md
new file mode 100644
index 0000000000..c694eb2092
--- /dev/null
+++ b/src/docs/ja-JP/general/report-issue.md
@@ -0,0 +1,10 @@
+# 不具合の報告
+不具合と思われる状況に遭遇したときは、まず[トラブルシューティング](./troubleshooting)をご確認ください。
+それでも問題が解決しないときは、以下の情報を含めて[フォーラム](https://forum.misskey.io/)に投稿してください。
+投稿することで、解決策が見つかったり、不具合と判断されれば開発チームによって修正が行われます。
+
+## 含める情報
+- Misskeyのバージョン([情報ページ](/about)で確認できます)
+- お使いのブラウザの種類とバージョン
+- お使いのOSの種類とバージョン
+- 問題の再現手順
diff --git a/src/docs/ja-JP/general/troubleshooting.md b/src/docs/ja-JP/general/troubleshooting.md
index d3b53d5482..e44eddd3ba 100644
--- a/src/docs/ja-JP/general/troubleshooting.md
+++ b/src/docs/ja-JP/general/troubleshooting.md
@@ -1,5 +1,6 @@
 # トラブルシューティング
 問題が発生したときは、まずこちらをご確認ください。
+該当する項目が無い、もしくは手順を試しても効果がない場合は、サーバーの管理者に連絡するか[不具合を報告](./report-issue)してください。
 
 ## クライアントが起動しない
 ほとんどの場合、お使いのブラウザまたはOSのバージョンが古いことが原因です。
@@ -7,6 +8,13 @@
 
 これは稀ですが、それでも起動しない場合は、キャッシュが原因の場合があります。ブラウザのキャッシュをクリアして、再度試してみてください。
 
+## クライアントの動作が遅い
+以下を試してみてください:
+
+- クライアント設定で「UIのアニメーションを減らす」を有効にする
+- お使いのブラウザの設定でハードウェアアクセラレーションを有効にする
+- お使いのデバイスのスペックを上げる
+
 ## 通知やアンテナ等の点滅が消えない
 点滅は、未読のコンテンツがあることを示しています。通常点滅が消えない場合は、コンテンツを遡ると未読なコンテンツが残っています。
 すべて既読にしたと思われるのに、それでもなお点滅が続く場合(おそらく不具合と思われます)は設定から強制的にすべて既読扱いにすることができます。