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

しっかりとしたREADMEを書こう #22

Closed
sotetsuk opened this issue Oct 7, 2020 · 0 comments · Fixed by #23
Closed

しっかりとしたREADMEを書こう #22

sotetsuk opened this issue Oct 7, 2020 · 0 comments · Fixed by #23

Comments

@sotetsuk
Copy link
Owner

sotetsuk commented Oct 7, 2020

他のユーザや、 将来の自分のため、 きちんとREADMEを書きましょう。

READMEでは、

  1. 何のためのコードなのか
    • ここでは、Fizz Buzzルールに沿った数字の変換のため
  2. どのようにインストールすれば使えるのか(開発環境、依存ライブラリ、インストールのためのコマンドなど)
    • 今回は $ make install コマンドでインストールができる
  3. 簡単な例をひとまず実行するにはどうすればいいのか(エントリーポイント・実行例)

を書いておけば、ひとまず使い始めることができるはずなので、これらに重点を置いて書いてみましょう。今回のFizzBuzzプログラムの例はこちらになります。

image

最後に

このチュートリアルがいいなと思ったらStarお願いします!

Screen Shot 2020-10-08 at 16 31 28

また、ここで使ったCIやテストの構成は、テンプレート化したものが sotetsuk/python-template から利用できるので、こちらも参照してみて下さい。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant