Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

方針の提案: 操作説明はMisskey Hubに委ねるのではなくMisskeyのUI内でほとんど完結させる #10472

Open
tamaina opened this issue Apr 4, 2023 · 11 comments
Labels
✨Feature This adds/improves/enhances a feature 🔥high priority packages/frontend Client side specific issue/PR

Comments

@tamaina
Copy link
Contributor

tamaina commented Apr 4, 2023

Summary

  • Misskey Hubで翻訳する言語が増えるとその倍数分だけMarkdownが増えてMisskey Hubが肥大化する
  • Misskey Hubは巨大なのでmisskey-dev/misskeyへのモノリポ化は困難
  • Misskey本体へ適用された変更がMisskey Hubへ適用されない場合がある
  • そもそもMisskey Hubが対象とするバージョンとmisskey.ioはじめ各サーバーで動作しているバージョンが異なる場合は多く、説明が噛み合わない懸念がある
  • 説明のためにユーザーをMisskey Hubへ誘導するのはちょっと不親切(通常8割を占めるスマホユーザーにとってマルチタスクはやや厳しい)

複数行の説明を書くためにテキストをファイルへ分割したい場合でも、Crowdinで対応できるはず…

@tamaina tamaina added the ✨Feature This adds/improves/enhances a feature label Apr 4, 2023
@syuilo
Copy link
Member

syuilo commented Apr 5, 2023

これ考えてたけどどうしようか迷ってる

@syuilo
Copy link
Member

syuilo commented Apr 5, 2023

そうする方向で

@kakkokari-gtyih
Copy link
Contributor

kakkokari-gtyih commented Apr 15, 2023

実際にやってみた(WIP)

develop...kakkokari-gtyih:misskey:docs

https://github.com/kakkokari-gtyih/misskey/tree/docs

@syuilo
Copy link
Member

syuilo commented Apr 15, 2023

実際にやってみた(WIP)

develop...kakkokari-gtyih:misskey:docs

ユーザー向けの操作説明とか機能説明はMisskey Hubじゃなくても良いんじゃないということだと思ってた

サーバー管理者向けの設定の説明だとかそういうのはMisskey Hubで良いと思った

@syuilo
Copy link
Member

syuilo commented Apr 15, 2023

そうしないと「実際にMisskeyサーバーを建てないとサーバー設定に関する説明が読めない」ことになってしまう

@kakkokari-gtyih
Copy link
Contributor

ユーザー向けの操作説明とか機能説明はMisskey Hubじゃなくても良いんじゃないということだと思ってた

Docsは一旦動作確認のためにおいてみただけなので…

@tamaina
Copy link
Contributor Author

tamaina commented Apr 15, 2023

docsのディレクトリをバサッと置くのではなく説明をせっていなどのUIに練り込むという感じが望ましいかも

@syuilo
Copy link
Member

syuilo commented Apr 15, 2023

docsのディレクトリをバサッと置くのではなくUIに練り込むという感じが望ましいかも

これをイメージしてる

@kakkokari-gtyih
Copy link
Contributor

kakkokari-gtyih commented Apr 15, 2023

「?」マークをホバーすれば短い説明が出てくるみたいな感じですか?

@syuilo
Copy link
Member

syuilo commented Apr 15, 2023

そういうのもあるし機能を使う前にチュートリアルが出てくるとかも考えられる

@EbiseLutica EbiseLutica pinned this issue Apr 17, 2023
@syuilo
Copy link
Member

syuilo commented May 17, 2023

現行バージョンにあるタイムラインのチュートリアルというか説明をクリップとかアンテナにも用意したい

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
✨Feature This adds/improves/enhances a feature 🔥high priority packages/frontend Client side specific issue/PR
Projects
Status: Todo
Development

No branches or pull requests

3 participants