みんなのPython勉強会#58のまとめ
reSTのほうがSphinxにとってメリットでかいよ というのはまあ分かるんだけど、たとえばScrapboxを「Markdown対応でない」というだけで避ける人がいるみたいな感じで、デファクトスタンダードをやめさせるならそれを上回るメリットが必要なのかな と #stapy
2020-06-10 20:44:26@TakamiChie 「良いものがはやるわけではない。」ですよね。わかります。 でも、何をしたいかで道具を選ぶべきで、それが明確であれば何を使われても良いと思います。
2020-06-10 20:44:28@takaneh ありました。 [python] クラス図を自動生成する - Qiita qiita.com/kenichi-hamagu… #stapy
2020-06-10 20:47:49「開発環境標準化」などでこういう話がよく出るのですが、「なぜそれを選ぶのか」が明確であることが大事であって、それが「デファクトスタンダードであること」が大事なのか、「そのツールを使うことで実現できることが明確にあること」なのかは、その組織の決断次第ですよね。 #stapy twitter.com/TakamiChie/sta…
2020-06-10 20:48:13そういえばPythonでコード書いたとき、VSCodeにflake8拡張入れたら、こういうコメント書け、みたいな警告が出たので書いたんだけど、あれ、Sphinxに食わせるとこんなドキュメントが出てくるようになるのか。知らんかった。。。 #stapy
2020-06-10 20:48:27今放置してるライブラリの手入れをするときに、一緒にsphinxでドキュメント作っていこう。 いろんな方に使えるように頑張りたい #stapy
2020-06-10 20:50:33autodocやっぱりよさそう。型アノテーションも行けるけど、古めのバージョン対応ってどうするか悩みそう。 #stapy
2020-06-10 20:52:09#stapy autodocはPythonコードのdocstringをちょっと書くだけでドキュメントができる!やらなければいけないこと(ドキュメント)が手短にできそうなので、これはやってみたいです - docstringを書き始める - :param 変数名: 説明 という記法 - 型アノテーションもドキュメントに反映される
2020-06-10 20:54:24みんなのPython勉強会は実は3年前の第25回から(会場開催とあわせて)ライブ配信してて、過去開催の動画も今日配信のチャネルで観ることができます。 よかったらチャネル登録、高評価おねがいします! youtu.be/euiqryTk5uk #stapy
2020-06-10 20:55:38