ユーザーガイドを作る

[kenkoooo]

#907 でユーザーガイドを作り始めようとしたが、やる気が続かなかった。

[polyester-CTRL]

作ってみたいです！

[kenkoooo]

お願いします！

[polyester-CTRL]

ガイドの項目や、ファイル構成はPull Requestの #907 を参考にしようと考えています。
それでよろしいでしょうか？

[kenkoooo]

正直 #907 をどんな気持ちで作ろうとしていたか完全に忘れてしまったのですが、たぶんいいと思います！

ファイル構成については全然こだわりはないのですが、 #907 では mdBook というツールを使って markdown からウェブ本を自動生成しようとしていて、このファイル構成は mdbook 用のものだった記憶があります。

[polyester-CTRL]

ありがとうございます！
markdownから自動生成する手法は、編集の手間がかからない点から採用したいと思います。

[polyester-CTRL]

開発者向けの情報はこちらを全部コピペすれば完成してしまうのでは？と思っています。
https://kenkoooo.hatenablog.com/entry/2019/12/01/011525

いかがでしょうか？

[kenkoooo]

開発者向け情報はゼロで大丈夫です！

[polyester-CTRL]

分かりました。ちなみに優先順位を付けるとしたらどんな情報（問題の探し方、バーチャルコンテスト関係、トレーニングモードなど）から作るといいでしょうか？

[kenkoooo]

全くのゼロなので、好きなところ初めていただいて構いません！自分がよく使う機能から書くのが書きやすそうです。類似の記事を見た感じ、問題の探し方が一番需要がありそうです。

https://ntk-ta01.hatenablog.com/entry/2020/04/15/001405
https://note.com/momomo0214/n/nc38bb4ea82aa

[polyester-CTRL]

https://github.com/polyester-CTRL/AtCoderProblems/tree/feature/993/guide-ja
とりあえず本文を一通り書きました。
端末上でAtCoderProblems/guide-ja/に移動して、mdbook serveと入力するとユーザーガイドをlocalhost:3000にてブラウザから確認できます。
説明の中で気になる箇所があれば、指摘を頂けると助かります。

この後に、このユーザーガイドへのリンクをどこかに貼る作業が必要だと思います。ですが、どうするのがベストなのか分からないので何もしていません。アドバイスを頂けると助かります。

[kenkoooo]

いったんプルリクを作っていただいて、細かいことは後で考えるということで良いと思います。