AtCoderProblems icon indicating copy to clipboard operation
AtCoderProblems copied to clipboard

ユーザーガイドを作る

Open kenkoooo opened this issue 4 years ago • 12 comments

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

kenkoooo avatar Jun 24 '21 14:06 kenkoooo

作ってみたいです!

polyester-CTRL avatar Jan 30 '22 07:01 polyester-CTRL

お願いします!

kenkoooo avatar Jan 30 '22 07:01 kenkoooo

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

polyester-CTRL avatar Jan 31 '22 02:01 polyester-CTRL

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

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

kenkoooo avatar Jan 31 '22 05:01 kenkoooo

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

polyester-CTRL avatar Jan 31 '22 11:01 polyester-CTRL

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

いかがでしょうか?

polyester-CTRL avatar Mar 17 '22 10:03 polyester-CTRL

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

kenkoooo avatar Mar 17 '22 10:03 kenkoooo

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

polyester-CTRL avatar Mar 17 '22 10:03 polyester-CTRL

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

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

kenkoooo avatar Mar 18 '22 16:03 kenkoooo

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

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

polyester-CTRL avatar Apr 06 '22 11:04 polyester-CTRL

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

kenkoooo avatar Apr 10 '22 10:04 kenkoooo

プルリクエストを作りました。確認をお願いします。

polyester-CTRL avatar Apr 10 '22 11:04 polyester-CTRL