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.

Sign up for GitHub

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

Jump to bottom

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

Open
tamaina opened this issue Apr 4, 2023 · 11 comments
Open

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

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 •
edited
Loading

実際にやってみた（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 •
edited
Loading

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

@syuilo
Copy link
Member

syuilo commented Apr 15, 2023

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

これをイメージしてる

@kakkokari-gtyih
Copy link
Contributor

kakkokari-gtyih commented Apr 15, 2023 •
edited
Loading

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

@syuilo
Copy link
Member

syuilo commented Apr 15, 2023

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

@EbiseLutica EbiseLutica pinned this issue Apr 17, 2023
@EbiseLutica EbiseLutica mentioned this issue Apr 17, 2023
Closed
4 tasks
@syuilo
Copy link
Member

syuilo commented May 17, 2023

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

@syuilo syuilo unpinned this issue May 31, 2023
@syuilo syuilo added packages/frontend Client side specific issue/PR 🔥high priority labels May 31, 2023
@kakkokari-gtyih kakkokari-gtyih mentioned this issue Oct 7, 2023
Closed
@zyoshoka zyoshoka mentioned this issue Jun 11, 2024
Open
@kakkokari-gtyih kakkokari-gtyih mentioned this issue Jun 22, 2024
Open
1 task
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
✨Feature This adds/improves/enhances a feature 🔥high priority packages/frontend Client side specific issue/PR
Projects
[FEATURE] Frontend
Status: Todo
Milestone
No milestone
Development

No branches or pull requests
3 participants
@syuilo @tamaina @kakkokari-gtyih