みんなのPython勉強会#58のまとめ
-
- いいね！45
kabukawa
@kabukawa
ドキュメントの構造化は凄くよく分かるんだけど、現場ではドキュメント書くために、ExcelだったりMarkdownだったり色々使い分けながらやらないといけない訳で、そのへんを上手く統合しながらやれる仕掛けを考えないといけないんだろうな。 #stapy
2020-06-10 20:55:40
abenben.eth
@abenben
吉田さんからPyCo JP Associationからのお知らせです！ #stapy pic.twitter.com/waQ6Jwt0E8
2020-06-10 20:57:36
拡大
HATANO Hirokazu
@tcsh
勘違いがあるといけないので言っておくと、「Sphinx使うととことん構造化できるけど、やれる範囲でやっておくだけでも全然違うよ」と言いたいのであって、「構造化するならここまでやれ」じゃないので、そのあたりご理解いただけるとありがたいです。 #stapy
2020-06-10 20:58:30
nikkie / にっきー
@ftnext
#stapy お知らせ中。7/4(土)開催のトークイベント！ pyconjp.connpass.com/event/177586/ 聞けるトークの概要 pyconjp.blogspot.com/2020/06/pychar… PSFへの恩返しという形で素敵な試みだと思います
2020-06-10 20:59:45
Takanori Suzuki
@takanory
Python Charity Talks in Japan はこちらです pyconjp.connpass.com/event/177586/ #pycharity #stapy
2020-06-10 21:00:41
nikkie / にっきー
@ftnext
#stapy 吉政さんのトークで出てきたLT（ポロシャツなど）のことでしたら、このあとの懇親会の予定です！ twitter.com/hrs_sano645/st…
2020-06-10 21:01:31
kabukawa
@kabukawa
21時になってしまったので撤収します。 今日はドキュメント作成環境を色々改善をしていくために参考になるお話が聞けてよかったです。ありがとうございました！ #stapy
2020-06-10 21:01:46
abenben.eth
@abenben
Python Charity Talks in Japan スポンサー、参加者ともに募集中です！ 僕も発表します。あと僕の誕生日ですw pyconjp.connpass.com/event/177586/ #stapy #pycharity pic.twitter.com/pqpEBsLPCL
2020-06-10 21:01:53
拡大
nikkie / にっきー
@ftnext
#stapy PyCon JPの活動はこんな雰囲気です。 pyconjp.blogspot.com/2020/06/pycon-… このブログは熱くてとても素敵なので、同じ感想を抱く方がいたらきっとスタッフ楽しめると思います
2020-06-10 21:03:16
HATANO Hirokazu
@tcsh
@TakamiChie なるほど。 Markdownって何が良くって流行っているんですかねぇ... (流行っているから使われているとしか認知していないのです。)
2020-06-10 21:03:20
高見知英
@TakamiChie
せっかくこういう機会なので、ITコミュニティ以外からもスタッフ集められればいいなあ と思ってはいる。 文系地域コミュニティからとかでも分野によっては参加できたりするし。 #stapy
2020-06-10 21:03:34
nikkie / にっきー
@ftnext
#stapy #pyconjp 2020のキーノートはRich Jonesさんです。 Zappaの作者というと思い当たる方多いんじゃないでしょうか pyconjp.blogspot.com/2020/06/pycon-…
2020-06-10 21:04:20
tk0miya
@tk0miya
markdown か reST のどちらが良いのかは、チームで議論するとよいと思います。マークアップの表現力の差から記述できないものもありますが(工夫しないと autodoc が使えなかったり…)、チームが書き慣れているものを使うのがいいと思います。 #stapy
2020-06-10 21:04:21
HYO_GO
@HYO_GO
こんなのもあった。 sphinx-pyreverse pypi.org/project/sphinx… #stapy twitter.com/TakamiChie/sta…
2020-06-10 21:05:45
高見知英
@TakamiChie
@takaneh ありました。 [python] クラス図を自動生成する - Qiita qiita.com/kenichi-hamagu… #stapy
2020-06-10 20:47:49
吉田@板橋
@koedoyoshida
今日の資料です PyCon JP Association からのお知らせ speakerdeck.com/koedoyoshida/p… #stapy
2020-06-10 21:06:06
HATANO Hirokazu
@tcsh
reSTructured Textとmarkdownの差異は「自動生成のやりやすさ」「可読性」かな。 markdownは人が書くもの。だけど人が読みソースではない。 reSTは、自動生成が容易、人が読みやすいソース。(directiveを使っていない場合は特に)
2020-06-10 21:07:17
nikkie / にっきー
@ftnext
#stapy ドキュメント会、ご参加 誠にありがとうございました。 このあとはZoom懇親会です。 お時間ある方はご参加ください（参加方法はYouTubeにあります）
2020-06-10 21:10:13
篠田 将彦 / CI・CD, DevOps, TDD
@Shinoda_IT
このあと zoom の懇親会で、 MarkDown と YAML で執筆する MkDocs というドキュメント生成ツールについて LT させていただきます reStructuredText or MarkDown ? #stapy docs.google.com/presentation/d…
2020-06-10 21:16:23