Open syuilo opened 1 year ago
VitePressに独自機能山盛りにするよりは、これを機に自由度の高いNuxtベース等で作ると、将来的に特設ページを作る際などに楽そう
一応、NuxtにもContent Moduleというマークダウンをよしなに処理してくれるモジュール(プラグイン)があるので、ドキュメントのメンテナンスという観点でもおそらく問題ないかと
(前勝手に作ったやつを参考程度に貼っておきます。こいつはNuxtです Related to #278 ) https://github.com/kakkokari-gtyih/about-misskey
これをwipから完成状態にするにはどれくらいのパワーが必要そうかしら 開発費の提供も可能
@syuilo 費用というよりかは私のスケジュールの確保が難しそうなので何とも言えないですね・・・私ももちろん進められるようにはしますが、ほかの方に適宜コントリビュートしていただかないと時間かかりそうです
あと、API関連の情報に関してはmisskey-jsに依存させる構造にしてある(エンドポイント一覧についてもそうするのが楽そう?)ので、その部分に関しては、misskey-jsの整備が進まないと実装に入れなさそうかもしれません https://github.com/misskey-dev/misskey/pull/10752
それ以外で残っている作業として一番デカいのが既存のドキュメントの引っ越し作業になる(導線を改善するためにディレクトリ構造を変更している)のですが、それに関しては、ほかの方のご協力も仰いで進めることも簡単にできるのではないかと思います
残っている作業(参考)
なるほど でもtailwind使ってることを考えると参考に留めて自分で1から作った方が今後を考えると良い可能性あるわね
(あまりTailwindは好ましくないですかね・・・?)
今からMisskey Hubのためだけにtailwind学習するのは難しいかも
今からMisskey Hubのためだけにtailwind学習するのは難しいかも
24年4月以降は個人的に時間に余裕ができるので、それ以降なら私がサイトの面倒見れると思います (サイトのコンテンツ自体の更新はMarkdownベースなので、軽い修正ならしゅいろさんでもできるとおもうし、ほかのコントリビューターさんでTailwind等に詳しい人に助けてもらうこともできる)
APIドキュメント以外はほぼできたとおもう
APIドキュメントも各エンドポイントのJSONを引っ張ってくるところまでは完了した
https://github.com/kakkokari-gtyih/about-misskey/tree/api-doc-gen
https://api-doc-gen.about-mk-kg.pages.dev/ja/docs/for-developers/api/endpoints/
うおおおおおおしゅごい
ただ、これはMisskey-jsではなく、Misskey本体のOpenAPI(っぽい)JSONを使ってやっています いまは一旦「のえすきー」のOpenAPI仕様書JSONを取得するようにハードコーディングしてあります
API表示のコンポーネント作成で挫折したのでタスケテ…
もう https://github.com/kakkokari-gtyih/about-misskey をこのリポジトリにマージしたい
というより別リポジトリにした方が良いかしら(そのままmisskey-devにtransferしてもらう)
抜本的にディレクトリを見直したせいでリンク切れが頻発しているのと、ローカライズ版の引っ越しがめんどくさすぎる問題がある…
ローカライズ版の引っ越しをどうすればいいか悩む(おそらくマンパワーが一番はやい)
今後Crowdinで管理したいから別に引っ越す必要はなさそう
今後Crowdinで管理したいから別に引っ越す必要はなさそう
about-misskeyはDocsも含め全面Crowdin管理仕様にしてあるのですが、それでもやはり既存のドキュメントは移したほうが翻訳作業がだいぶ楽になる気がするんですよね
Crowdinって既存のドキュメント取り込む機能なかった気がする
あるにはある これはこれで面倒くさそう()
とりあえずCrowdinと連携させて(外国語ファイルは除く)、マンパワーで移行やるのが楽なのかも(CrowdinはGUIなので非エンジニアでもできる)
で、APIエンドポイントはHQにやってもらっているのでとりあえず放置で大丈夫そう
後継らしい