Enviar pesquisa
Carregar
ドキュメント、書いてますか? @ Python hack-a-thon 2011/2
•
Transferir como PPTX, PDF
•
1 gostou
•
1,883 visualizações
Takeshi Komiya
Seguir
Tecnologia
Arte e fotografia
Denunciar
Compartilhar
Denunciar
Compartilhar
1 de 33
Baixar agora
Recomendados
Pythonでアルゴレイヴの世界に足を踏み入れる
Pythonでアルゴレイヴの世界に足を踏み入れる
ksnt
Seq2Seqでボットづくり
Seq2Seqでボットづくり
Masato Fujitake
グラフデータベース「Neo4j」の 導入の導入(続き)-Cypherの基本のキ-
グラフデータベース「Neo4j」の 導入の導入(続き)-Cypherの基本のキ-
Hisao Soyama
Pythonでターミナルに画像表示
Pythonでターミナルに画像表示
Masato Fujitake
コボラーがPython始めてみた話
コボラーがPython始めてみた話
Yuuki Nakajima
S01 t1 tsuji_pylearn_ut_01
S01 t1 tsuji_pylearn_ut_01
Takeshi Akutsu
ローポリで見えてくるポリゴンのあれやこれ
ローポリで見えてくるポリゴンのあれやこれ
kappa1116jp
191208 python-kansai-nishimoto
191208 python-kansai-nishimoto
Takuya Nishimoto
Recomendados
Pythonでアルゴレイヴの世界に足を踏み入れる
Pythonでアルゴレイヴの世界に足を踏み入れる
ksnt
Seq2Seqでボットづくり
Seq2Seqでボットづくり
Masato Fujitake
グラフデータベース「Neo4j」の 導入の導入(続き)-Cypherの基本のキ-
グラフデータベース「Neo4j」の 導入の導入(続き)-Cypherの基本のキ-
Hisao Soyama
Pythonでターミナルに画像表示
Pythonでターミナルに画像表示
Masato Fujitake
コボラーがPython始めてみた話
コボラーがPython始めてみた話
Yuuki Nakajima
S01 t1 tsuji_pylearn_ut_01
S01 t1 tsuji_pylearn_ut_01
Takeshi Akutsu
ローポリで見えてくるポリゴンのあれやこれ
ローポリで見えてくるポリゴンのあれやこれ
kappa1116jp
191208 python-kansai-nishimoto
191208 python-kansai-nishimoto
Takuya Nishimoto
他人が書いたコードのリファレンスをSphinxで作る方法
他人が書いたコードのリファレンスをSphinxで作る方法
Takeshi Sugiyama
stapy#23 LT
stapy#23 LT
NaoY-2501
初心者が Python で戸惑ったところ
初心者が Python で戸惑ったところ
Emma Haruka Iwao
S03 t1 python_learningdiary#3
S03 t1 python_learningdiary#3
Takeshi Akutsu
S09 t0 orientation
S09 t0 orientation
Takeshi Akutsu
オープンソースBotフレームワークではじめるChatOps
オープンソースBotフレームワークではじめるChatOps
Akihiko Horiuchi
S10 t1 spc_by_nowfromnow
S10 t1 spc_by_nowfromnow
Takeshi Akutsu
print("Hello World")を実行する - Pythonコードからスタック型仮想マシンまで
print("Hello World")を実行する - Pythonコードからスタック型仮想マシンまで
Richard Rowland
pythonでemlファイルを扱う話
pythonでemlファイルを扱う話
Satoshi Yamada
S08 t0 orientation
S08 t0 orientation
Takeshi Akutsu
【Web系最高って言うけど本当なの?】siの5次請けから離脱したエンジニアが話してみた
【Web系最高って言うけど本当なの?】siの5次請けから離脱したエンジニアが話してみた
Yuuki Nakajima
Python入門者の集い #6 Lightning Talk
Python入門者の集い #6 Lightning Talk
Katayanagi Nobuko
Perl で自然言語処理
Perl で自然言語処理
Toshinori Sato
はてブ未読管理
はてブ未読管理
kiki utagawa
PyLadies Tokyo - 初心者向けPython体験ワークショップ開催の裏側
PyLadies Tokyo - 初心者向けPython体験ワークショップ開催の裏側
Katayanagi Nobuko
S01 t2 akutsu_my_pythonhistory
S01 t2 akutsu_my_pythonhistory
Takeshi Akutsu
気の合う人達と社外で社内勉強会
気の合う人達と社外で社内勉強会
Yu Shibatsuji
210630 python
210630 python
Takuya Nishimoto
お前の逐モン、GETだぜ!
お前の逐モン、GETだぜ!
Nagi Teramo
Python学習奮闘記#07 webapp
Python学習奮闘記#07 webapp
Takeshi Akutsu
【NYSOL】ビッグデータをシンプル・高速に!日本発の大規模データ解析用OSS
【NYSOL】ビッグデータをシンプル・高速に!日本発の大規模データ解析用OSS
NYSOL
ドキュメント生成ツールのお話
ドキュメント生成ツールのお話
Shota Homma
Mais conteúdo relacionado
Mais procurados
他人が書いたコードのリファレンスをSphinxで作る方法
他人が書いたコードのリファレンスをSphinxで作る方法
Takeshi Sugiyama
stapy#23 LT
stapy#23 LT
NaoY-2501
初心者が Python で戸惑ったところ
初心者が Python で戸惑ったところ
Emma Haruka Iwao
S03 t1 python_learningdiary#3
S03 t1 python_learningdiary#3
Takeshi Akutsu
S09 t0 orientation
S09 t0 orientation
Takeshi Akutsu
オープンソースBotフレームワークではじめるChatOps
オープンソースBotフレームワークではじめるChatOps
Akihiko Horiuchi
S10 t1 spc_by_nowfromnow
S10 t1 spc_by_nowfromnow
Takeshi Akutsu
print("Hello World")を実行する - Pythonコードからスタック型仮想マシンまで
print("Hello World")を実行する - Pythonコードからスタック型仮想マシンまで
Richard Rowland
pythonでemlファイルを扱う話
pythonでemlファイルを扱う話
Satoshi Yamada
S08 t0 orientation
S08 t0 orientation
Takeshi Akutsu
【Web系最高って言うけど本当なの?】siの5次請けから離脱したエンジニアが話してみた
【Web系最高って言うけど本当なの?】siの5次請けから離脱したエンジニアが話してみた
Yuuki Nakajima
Python入門者の集い #6 Lightning Talk
Python入門者の集い #6 Lightning Talk
Katayanagi Nobuko
Perl で自然言語処理
Perl で自然言語処理
Toshinori Sato
はてブ未読管理
はてブ未読管理
kiki utagawa
PyLadies Tokyo - 初心者向けPython体験ワークショップ開催の裏側
PyLadies Tokyo - 初心者向けPython体験ワークショップ開催の裏側
Katayanagi Nobuko
S01 t2 akutsu_my_pythonhistory
S01 t2 akutsu_my_pythonhistory
Takeshi Akutsu
気の合う人達と社外で社内勉強会
気の合う人達と社外で社内勉強会
Yu Shibatsuji
210630 python
210630 python
Takuya Nishimoto
お前の逐モン、GETだぜ!
お前の逐モン、GETだぜ!
Nagi Teramo
Python学習奮闘記#07 webapp
Python学習奮闘記#07 webapp
Takeshi Akutsu
Mais procurados
(20)
他人が書いたコードのリファレンスをSphinxで作る方法
他人が書いたコードのリファレンスをSphinxで作る方法
stapy#23 LT
stapy#23 LT
初心者が Python で戸惑ったところ
初心者が Python で戸惑ったところ
S03 t1 python_learningdiary#3
S03 t1 python_learningdiary#3
S09 t0 orientation
S09 t0 orientation
オープンソースBotフレームワークではじめるChatOps
オープンソースBotフレームワークではじめるChatOps
S10 t1 spc_by_nowfromnow
S10 t1 spc_by_nowfromnow
print("Hello World")を実行する - Pythonコードからスタック型仮想マシンまで
print("Hello World")を実行する - Pythonコードからスタック型仮想マシンまで
pythonでemlファイルを扱う話
pythonでemlファイルを扱う話
S08 t0 orientation
S08 t0 orientation
【Web系最高って言うけど本当なの?】siの5次請けから離脱したエンジニアが話してみた
【Web系最高って言うけど本当なの?】siの5次請けから離脱したエンジニアが話してみた
Python入門者の集い #6 Lightning Talk
Python入門者の集い #6 Lightning Talk
Perl で自然言語処理
Perl で自然言語処理
はてブ未読管理
はてブ未読管理
PyLadies Tokyo - 初心者向けPython体験ワークショップ開催の裏側
PyLadies Tokyo - 初心者向けPython体験ワークショップ開催の裏側
S01 t2 akutsu_my_pythonhistory
S01 t2 akutsu_my_pythonhistory
気の合う人達と社外で社内勉強会
気の合う人達と社外で社内勉強会
210630 python
210630 python
お前の逐モン、GETだぜ!
お前の逐モン、GETだぜ!
Python学習奮闘記#07 webapp
Python学習奮闘記#07 webapp
Destaque
【NYSOL】ビッグデータをシンプル・高速に!日本発の大規模データ解析用OSS
【NYSOL】ビッグデータをシンプル・高速に!日本発の大規模データ解析用OSS
NYSOL
ドキュメント生成ツールのお話
ドキュメント生成ツールのお話
Shota Homma
Markdownでドキュメント作成
Markdownでドキュメント作成
Yasuyuki Fujikawa
APIドキュメントの話 #sphinxjp
APIドキュメントの話 #sphinxjp
Takeshi Komiya
Sphinxの使い方事例
Sphinxの使い方事例
Go Yamada
Sphinxで社内勉強会(Git)の 資料を作ってみた
Sphinxで社内勉強会(Git)の 資料を作ってみた
Taku SHIMIZU
月刊ライトニングトーク 12月号
月刊ライトニングトーク 12月号
Masaki Yamamoto
ドキュメントシステムはこれを使え2015年版
ドキュメントシステムはこれを使え2015年版
Keiichiro Shikano
ドキュメントを作りたくなってしまう魔法のツールSphinx
ドキュメントを作りたくなってしまう魔法のツールSphinx
Takayuki Shimizukawa
Destaque
(9)
【NYSOL】ビッグデータをシンプル・高速に!日本発の大規模データ解析用OSS
【NYSOL】ビッグデータをシンプル・高速に!日本発の大規模データ解析用OSS
ドキュメント生成ツールのお話
ドキュメント生成ツールのお話
Markdownでドキュメント作成
Markdownでドキュメント作成
APIドキュメントの話 #sphinxjp
APIドキュメントの話 #sphinxjp
Sphinxの使い方事例
Sphinxの使い方事例
Sphinxで社内勉強会(Git)の 資料を作ってみた
Sphinxで社内勉強会(Git)の 資料を作ってみた
月刊ライトニングトーク 12月号
月刊ライトニングトーク 12月号
ドキュメントシステムはこれを使え2015年版
ドキュメントシステムはこれを使え2015年版
ドキュメントを作りたくなってしまう魔法のツールSphinx
ドキュメントを作りたくなってしまう魔法のツールSphinx
Semelhante a ドキュメント、書いてますか? @ Python hack-a-thon 2011/2
sphinx + blockdiag で始めるドキュメント生活 2011/05 yokohama.pm
sphinx + blockdiag で始めるドキュメント生活 2011/05 yokohama.pm
Takeshi Komiya
Python エンジニアの作り方 2011.08 #pyconjp
Python エンジニアの作り方 2011.08 #pyconjp
Takeshi Komiya
IoTの原点
IoTの原点
Shinichi Takahashi
OSS Study#19_LT
OSS Study#19_LT
NaoY-2501
本気でPythonで宛名書きした話
本気でPythonで宛名書きした話
Satoshi Yamada
最近思った機械学習(PyTorch)のベストプラクティス
最近思った機械学習(PyTorch)のベストプラクティス
Masato Fujitake
データ分析スクリプトのツール化入門 - PyConJP 2016
データ分析スクリプトのツール化入門 - PyConJP 2016
Akinori Kohno
Bottle使ってPython学習一緒にはじめませんか?
Bottle使ってPython学習一緒にはじめませんか?
Tatsuya Shinozuka
Rでを作る
Rでを作る
Nagi Teramo
Pythonで自動化した話1
Pythonで自動化した話1
Masato Fujitake
Django から各種チャットツールに通知するライブラリを作った話
Django から各種チャットツールに通知するライブラリを作った話
Yusuke Miyazaki
Python札幌 2012/06/17
Python札幌 2012/06/17
Shinya Okano
Sphinxでまとめる多言語環境APIドキュメント
Sphinxでまとめる多言語環境APIドキュメント
Iosif Takakura
Tokyo.R女子部発表スライド「Rではじめるデータ解析の超基礎」
Tokyo.R女子部発表スライド「Rではじめるデータ解析の超基礎」
tokyorgirls
Python勉強会 2015-12-02
Python勉強会 2015-12-02
WoodPecker (Shizuoka Univ)
Pyladies tokyo 20150123
Pyladies tokyo 20150123
Ai Makabi
ドキュメントを加速する作画ツール Blockdiag 2011/07 #infotalk
ドキュメントを加速する作画ツール Blockdiag 2011/07 #infotalk
Takeshi Komiya
Why python
Why python
Mikio Kubo
Open xINT CTF Bus Writeup@shunaroo
Open xINT CTF Bus Writeup@shunaroo
shuna roo
Why python
Why python
Mikio Kubo
Semelhante a ドキュメント、書いてますか? @ Python hack-a-thon 2011/2
(20)
sphinx + blockdiag で始めるドキュメント生活 2011/05 yokohama.pm
sphinx + blockdiag で始めるドキュメント生活 2011/05 yokohama.pm
Python エンジニアの作り方 2011.08 #pyconjp
Python エンジニアの作り方 2011.08 #pyconjp
IoTの原点
IoTの原点
OSS Study#19_LT
OSS Study#19_LT
本気でPythonで宛名書きした話
本気でPythonで宛名書きした話
最近思った機械学習(PyTorch)のベストプラクティス
最近思った機械学習(PyTorch)のベストプラクティス
データ分析スクリプトのツール化入門 - PyConJP 2016
データ分析スクリプトのツール化入門 - PyConJP 2016
Bottle使ってPython学習一緒にはじめませんか?
Bottle使ってPython学習一緒にはじめませんか?
Rでを作る
Rでを作る
Pythonで自動化した話1
Pythonで自動化した話1
Django から各種チャットツールに通知するライブラリを作った話
Django から各種チャットツールに通知するライブラリを作った話
Python札幌 2012/06/17
Python札幌 2012/06/17
Sphinxでまとめる多言語環境APIドキュメント
Sphinxでまとめる多言語環境APIドキュメント
Tokyo.R女子部発表スライド「Rではじめるデータ解析の超基礎」
Tokyo.R女子部発表スライド「Rではじめるデータ解析の超基礎」
Python勉強会 2015-12-02
Python勉強会 2015-12-02
Pyladies tokyo 20150123
Pyladies tokyo 20150123
ドキュメントを加速する作画ツール Blockdiag 2011/07 #infotalk
ドキュメントを加速する作画ツール Blockdiag 2011/07 #infotalk
Why python
Why python
Open xINT CTF Bus Writeup@shunaroo
Open xINT CTF Bus Writeup@shunaroo
Why python
Why python
Mais de Takeshi Komiya
マークアップ言語の拡張 メリットとデメリット #hankumi
マークアップ言語の拡張 メリットとデメリット #hankumi
Takeshi Komiya
ドキュメントの話、しませんか? #428rk01
ドキュメントの話、しませんか? #428rk01
Takeshi Komiya
Sphinx拡張 探訪 2014 #sphinxjp
Sphinx拡張 探訪 2014 #sphinxjp
Takeshi Komiya
個人的なさがしもののはなし #rubyhiroba
個人的なさがしもののはなし #rubyhiroba
Takeshi Komiya
俺の嫁と行った場所 #pykonjp2014
俺の嫁と行った場所 #pykonjp2014
Takeshi Komiya
発見・探検・ぼくのだいあぐ #pykonjp2014
発見・探検・ぼくのだいあぐ #pykonjp2014
Takeshi Komiya
Excel 方眼紙撲滅委員会 活動報告 2013.9 #yapcasia
Excel 方眼紙撲滅委員会 活動報告 2013.9 #yapcasia
Takeshi Komiya
Pythonユーザのための構成管理入門 #pyconapac
Pythonユーザのための構成管理入門 #pyconapac
Takeshi Komiya
Chef の気まぐれ環境構築 〜季節の Capistrano を添えて〜 #jawsug
Chef の気まぐれ環境構築 〜季節の Capistrano を添えて〜 #jawsug
Takeshi Komiya
Paratrooper chef の紹介 @ Chef Casual Talks Vol.2 #eytokyo
Paratrooper chef の紹介 @ Chef Casual Talks Vol.2 #eytokyo
Takeshi Komiya
明日から始める Chef 入門 #bpstudy
明日から始める Chef 入門 #bpstudy
Takeshi Komiya
Roundsmanの紹介 @ Chef Casual Talks Vol.1 #eytokyo
Roundsmanの紹介 @ Chef Casual Talks Vol.1 #eytokyo
Takeshi Komiya
春を先取り!OpsWorksとChef ではじめる恋色コーデ術! #pyfes 2013.03
春を先取り!OpsWorksとChef ではじめる恋色コーデ術! #pyfes 2013.03
Takeshi Komiya
Sphinx ではじめるドキュメント生活 2013 #sphinxconjp
Sphinx ではじめるドキュメント生活 2013 #sphinxconjp
Takeshi Komiya
Inside of excel 方眼紙撲滅委員会 #pyfes
Inside of excel 方眼紙撲滅委員会 #pyfes
Takeshi Komiya
Excel 方眼紙撲滅委員会 活動報告 2012.11 #odstudy
Excel 方眼紙撲滅委員会 活動報告 2012.11 #odstudy
Takeshi Komiya
Life with Sphinx 2012 #sphinxconjp
Life with Sphinx 2012 #sphinxconjp
Takeshi Komiya
Excel 方眼紙撲滅委員会 活動報告 2012.09 #yapcasia #ltthon
Excel 方眼紙撲滅委員会 活動報告 2012.09 #yapcasia #ltthon
Takeshi Komiya
Sphinx ではじめるドキュメント生活 2012 #pyconjp #sphinxconjp
Sphinx ではじめるドキュメント生活 2012 #pyconjp #sphinxconjp
Takeshi Komiya
Excel 方眼紙撲滅委員会 活動報告 2012.09 #pyconjp
Excel 方眼紙撲滅委員会 活動報告 2012.09 #pyconjp
Takeshi Komiya
Mais de Takeshi Komiya
(20)
マークアップ言語の拡張 メリットとデメリット #hankumi
マークアップ言語の拡張 メリットとデメリット #hankumi
ドキュメントの話、しませんか? #428rk01
ドキュメントの話、しませんか? #428rk01
Sphinx拡張 探訪 2014 #sphinxjp
Sphinx拡張 探訪 2014 #sphinxjp
個人的なさがしもののはなし #rubyhiroba
個人的なさがしもののはなし #rubyhiroba
俺の嫁と行った場所 #pykonjp2014
俺の嫁と行った場所 #pykonjp2014
発見・探検・ぼくのだいあぐ #pykonjp2014
発見・探検・ぼくのだいあぐ #pykonjp2014
Excel 方眼紙撲滅委員会 活動報告 2013.9 #yapcasia
Excel 方眼紙撲滅委員会 活動報告 2013.9 #yapcasia
Pythonユーザのための構成管理入門 #pyconapac
Pythonユーザのための構成管理入門 #pyconapac
Chef の気まぐれ環境構築 〜季節の Capistrano を添えて〜 #jawsug
Chef の気まぐれ環境構築 〜季節の Capistrano を添えて〜 #jawsug
Paratrooper chef の紹介 @ Chef Casual Talks Vol.2 #eytokyo
Paratrooper chef の紹介 @ Chef Casual Talks Vol.2 #eytokyo
明日から始める Chef 入門 #bpstudy
明日から始める Chef 入門 #bpstudy
Roundsmanの紹介 @ Chef Casual Talks Vol.1 #eytokyo
Roundsmanの紹介 @ Chef Casual Talks Vol.1 #eytokyo
春を先取り!OpsWorksとChef ではじめる恋色コーデ術! #pyfes 2013.03
春を先取り!OpsWorksとChef ではじめる恋色コーデ術! #pyfes 2013.03
Sphinx ではじめるドキュメント生活 2013 #sphinxconjp
Sphinx ではじめるドキュメント生活 2013 #sphinxconjp
Inside of excel 方眼紙撲滅委員会 #pyfes
Inside of excel 方眼紙撲滅委員会 #pyfes
Excel 方眼紙撲滅委員会 活動報告 2012.11 #odstudy
Excel 方眼紙撲滅委員会 活動報告 2012.11 #odstudy
Life with Sphinx 2012 #sphinxconjp
Life with Sphinx 2012 #sphinxconjp
Excel 方眼紙撲滅委員会 活動報告 2012.09 #yapcasia #ltthon
Excel 方眼紙撲滅委員会 活動報告 2012.09 #yapcasia #ltthon
Sphinx ではじめるドキュメント生活 2012 #pyconjp #sphinxconjp
Sphinx ではじめるドキュメント生活 2012 #pyconjp #sphinxconjp
Excel 方眼紙撲滅委員会 活動報告 2012.09 #pyconjp
Excel 方眼紙撲滅委員会 活動報告 2012.09 #pyconjp
Último
LoRaWAN スマート距離検出デバイスDS20L日本語マニュアル
LoRaWAN スマート距離検出デバイスDS20L日本語マニュアル
CRI Japan, Inc.
論文紹介: The Surprising Effectiveness of PPO in Cooperative Multi-Agent Games
論文紹介: The Surprising Effectiveness of PPO in Cooperative Multi-Agent Games
atsushi061452
論文紹介:Video-GroundingDINO: Towards Open-Vocabulary Spatio-Temporal Video Groun...
論文紹介:Video-GroundingDINO: Towards Open-Vocabulary Spatio-Temporal Video Groun...
Toru Tamaki
新人研修 後半 2024/04/26の勉強会で発表されたものです。
新人研修 後半 2024/04/26の勉強会で発表されたものです。
iPride Co., Ltd.
Amazon SES を勉強してみる その22024/04/26の勉強会で発表されたものです。
Amazon SES を勉強してみる その22024/04/26の勉強会で発表されたものです。
iPride Co., Ltd.
Amazon SES を勉強してみる その32024/04/26の勉強会で発表されたものです。
Amazon SES を勉強してみる その32024/04/26の勉強会で発表されたものです。
iPride Co., Ltd.
NewSQLの可用性構成パターン(OCHaCafe Season 8 #4 発表資料)
NewSQLの可用性構成パターン(OCHaCafe Season 8 #4 発表資料)
NTT DATA Technology & Innovation
LoRaWANスマート距離検出センサー DS20L カタログ LiDARデバイス
LoRaWANスマート距離検出センサー DS20L カタログ LiDARデバイス
CRI Japan, Inc.
論文紹介:Selective Structured State-Spaces for Long-Form Video Understanding
論文紹介:Selective Structured State-Spaces for Long-Form Video Understanding
Toru Tamaki
業務で生成AIを活用したい人のための生成AI入門講座(社外公開版:キンドリルジャパン社内勉強会:2024年4月発表)
業務で生成AIを活用したい人のための生成AI入門講座(社外公開版:キンドリルジャパン社内勉強会:2024年4月発表)
Hiroshi Tomioka
Observabilityは従来型の監視と何が違うのか(キンドリルジャパン社内勉強会:2022年10月27日発表)
Observabilityは従来型の監視と何が違うのか(キンドリルジャパン社内勉強会:2022年10月27日発表)
Hiroshi Tomioka
Último
(11)
LoRaWAN スマート距離検出デバイスDS20L日本語マニュアル
LoRaWAN スマート距離検出デバイスDS20L日本語マニュアル
論文紹介: The Surprising Effectiveness of PPO in Cooperative Multi-Agent Games
論文紹介: The Surprising Effectiveness of PPO in Cooperative Multi-Agent Games
論文紹介:Video-GroundingDINO: Towards Open-Vocabulary Spatio-Temporal Video Groun...
論文紹介:Video-GroundingDINO: Towards Open-Vocabulary Spatio-Temporal Video Groun...
新人研修 後半 2024/04/26の勉強会で発表されたものです。
新人研修 後半 2024/04/26の勉強会で発表されたものです。
Amazon SES を勉強してみる その22024/04/26の勉強会で発表されたものです。
Amazon SES を勉強してみる その22024/04/26の勉強会で発表されたものです。
Amazon SES を勉強してみる その32024/04/26の勉強会で発表されたものです。
Amazon SES を勉強してみる その32024/04/26の勉強会で発表されたものです。
NewSQLの可用性構成パターン(OCHaCafe Season 8 #4 発表資料)
NewSQLの可用性構成パターン(OCHaCafe Season 8 #4 発表資料)
LoRaWANスマート距離検出センサー DS20L カタログ LiDARデバイス
LoRaWANスマート距離検出センサー DS20L カタログ LiDARデバイス
論文紹介:Selective Structured State-Spaces for Long-Form Video Understanding
論文紹介:Selective Structured State-Spaces for Long-Form Video Understanding
業務で生成AIを活用したい人のための生成AI入門講座(社外公開版:キンドリルジャパン社内勉強会:2024年4月発表)
業務で生成AIを活用したい人のための生成AI入門講座(社外公開版:キンドリルジャパン社内勉強会:2024年4月発表)
Observabilityは従来型の監視と何が違うのか(キンドリルジャパン社内勉強会:2022年10月27日発表)
Observabilityは従来型の監視と何が違うのか(キンドリルジャパン社内勉強会:2022年10月27日発表)
ドキュメント、書いてますか? @ Python hack-a-thon 2011/2
1.
ドキュメント、書いてますか? 小宮 健
(@tk0miya) 2011-02-19
2.
おまえ誰よ? 小宮 健
(@tk0miya) 株式会社タイムインターメディア所属 技術者募集中らしいです Python 歴は約 1年ぐらい Sphinx-users の方から来ました 15時ぎりぎりまで資料作ってました 分かりづらかったらごめんなさい!
3.
はじめに このスライドの内容 ドキュメント、書いてますか?
Inside blockdiag (と仲間たち) 資料はあとで会社のブログにアップします http://labs.timedia.co.jp/ “TIM Labs” で検索してください
4.
ドキュメント、書いてますか?
5.
理想と現実 ドキュメントは書くべき。 実際のところは?
ドキュメント書く時間がない コスト (リソース) がない そもそも開発が終わらない 口伝でなりたっているプロジェクト = 一子相伝的プロジェクト
6.
こんな子いるかな? 「(納品しないから)今回はドキュメントなしで」 「機能一覧に書いてない機能がたくさんある」
「運用でカバーすることにしよう」 「仕様書はあったら嬉しいなって」 「ドキュメントなんて、あるわけない」 「こんなの絶対おかしいよ」
7.
誰のためのドキュメント? 納品物としてのドキュメント お客さんのもの
設計/運用のためのドキュメント 自分たちのもの もしくは引き継ぐ誰かのためものもの 大抵足りないのは設計/運用のためのドキュメント つまり困るのは自分たち!
8.
作ったはいいけれど… そのドキュメント、メンテナンスできてますか? 合ってないテーブル定義
足りない機能一覧 キャプチャが古いマニュアル 更新したいけどコスト/時間が足りない あとで泣くのは自分 もしくは引き継ぐ羽目になった誰か 書いて終わりではなく、メンテできる大きさが大事 立派である必要はない ドキュメントだって Lightweight 重要
9.
Lightweight なドキュメント ツールをうまく使う
Sphinx、Wiki で書く ソースに埋め込む -> docstringを Sphinx などで抽出 やり方を変える テンプレートでショートカットする shimizukawaテンプレート @ Sphinx-users 常に書き換える (Wiki 方式) 無理なく、楽しく、続けられるドキュメントであること
10.
ここまでのまとめ 設計/運用のためのドキュメントを書こう 書くだけじゃダメ、更新もしなくちゃ。
無理なく、続けられる方法が必要 Sphinx を使おう テンプレート化していこう Excel 方眼紙は止めよう ここのツールを作った
11.
Inside blockdiag (と仲間たち)
12.
blockdiag テキストから画面遷移図を生成するツール コマンドライン
/ Sphinx 拡張として動作 悪名高きExcel 方眼紙がイヤで作った 並べ替えるのが面倒、ずれる 、etc…
13.
blockdiagの特徴 定義ファイル(テキスト)から画像(PNG, SVG)を生成
Graphvizっぽい文法 (DOT like 文法) 自動的にレイアウトしてくれる 追加/削除が簡単 ずれたりしない 日本語 (UTF-8) 対応 easy_installblockdiagでインストール可能
14.
blockdiag の使い方 遷移図の定義を作ります
diagram { A -> B -> C; B -> D; } blockdiagコマンドで画像を生成 % blockdiag –o sample.png input.diag
15.
Inside blockdiag blockdiagは
4つのパートから構成される パーサ レイアウトエンジン 描画エンジン ノードレンダラー
16.
Inside blockdiag:パーサ DOT
文法 (graphviz由来) をまねた文法を採用 diagram { A -> B -> C; B -> D; } テキストでもわかりやすい (like reST!) ノード間の関係や属性をわかりやすく表現できる funcparserlibを利用してパーサを生成 依頼して Python 2.4 でも動くようにしてもらった
17.
Inside blockdiag:レイアウトエンジン レイアウトエンジン
X 軸(横方向)、Y 軸(縦方向) の順に並べている 説明が大変なので中身は割愛します 自分がきれいだと思うようにレイアウト 完全にヒューリスティック 「見やすさ」は感覚的なもので正解はない イマイチなものを見かけたら教えて下さい
18.
Inside blockdiag:描画エンジン blockdiagは
PNG/SVG/PDF 形式で出力できる バックエンドには PIL/SVGdraw.py/reportlabを利用
19.
Inside blockdiag:描画エンジン PIL
っぽいインターフェースで中間層を作っている line, rectangle, arc, ellipse などの API がそろってる 手がかかってる部分 PIL で点線を書けるようにした SVG でテキスト折り返し 影のぼかし部分
20.
Inside blockdiag:レンダラー ノードの形状は差し替え可能になっている
プラグインを書くことで形状を追加することができる
21.
Inside blockdiag:レンダラー 新しいシェイプを足す場合はプラグインを書く
図形を書く、塗る、ラベルを配置する、接点を調整する 図形の組み合わせで簡単に作れる 来週あたりにプラグインの書き方を公開するつもり 是非作って下さい
22.
Inside blockdiag:周辺ツール Interactive
shell デモツールとして大好評 Appengine上で動いている フォームを書き換える度にリクエストしている Appengineでは PIL が動かないので SVG 出力してる 問題点:blockdiagそのものだと勘違いされてる気がする
23.
Inside blockdiag:周辺ツール Web
クローラー Pycon mini JP のデモ用に作成 デザイナーさんからキャプチャ画像で遷移図を作るという話を聞いたので作ってみた urllib + lxmlでスクレイプ + クローリング 便利なクローラーライブラリを教えて下さい PyQtでキャプチャ取得 (by ransui先生) 生成される図がでかすぎて閲覧不能 デモ用と割り切って作り捨てることに。
24.
Inside blockdiag:周辺ツール Sphinx
言わずもしれた便利なアイツ Sphinx 拡張を使うと reSTに直接埋め込むことができる .. blockdiag:: diagram { A -> B -> C; B -> D; } Sphinx との組み合わせは超便利 (らしい)
25.
seqdiag テキストからシーケンス図を生成するツール コマンドライン
/ Sphinx 拡張として動作 @shimizukawa師匠の指示で作らされた作った
26.
ある日のできごと このイラストは実在の団体とは関係ありません Sphinx
のドキュメントにシーケンス図を埋め込みたい sdeditを使ったら? -> Java 入れるのイヤ。 作って。なう。
27.
blockdiag の使い方 シーケンス図の定義を作ります
diagram { browser => server; } seqdiagコマンドで画像を生成 % seqdiag –o sample.png input.diag
28.
Inside seqdiag blockdiagコアを利用して
2時間でプロトタイプ作成 1週間かけてちゃんと作り込んだ 以降、絶賛放置中 バグつぶしをしたら開発終了の予定 シンプルに書いて、それっぽい図ができる Blockdiagと同じような周辺ツールがある Interactive Shell Sphinx 拡張
29.
schema2rst DB スキーマから定義書を生成する
Foreign Key から ER 図っぽいものも生成できる サンプル 以前作った schema2excel.rb を Sphinx 向けにリファイン Rails 風の DB Migration システムと相性がいい気がする 作りながらスキーマを随時拡張していく
30.
Inside schema2rst スキーマ情報の抽出
Information_Schemaからごりごり SELECT してるだけ MySQLでコメントを付けておくと表現がリッチに 他の DBMS への対応はそのうち考えます ER 図の生成 dot ファイルを生成して Graphvizに渡してる テーブルが多すぎると図が大きくなって見づらい (体験談) 面倒なので bitbucketで公開してるだけ
31.
ここまでのまとめ blockdiagは謎の技術で動いているわけじゃない 普通の
Python スクリプト 素直なコードが多いので読みやすいはず 但しレイアウトエンジンを除く 要するに… Contributer募集。 ブロック図とか UML とか好きな人 ドキュメントを楽して書くために苦労できる人 道のりが遠すぎて燃え尽きそうです。助けて
32.
次の目標 ブロック図を作る 機能構成とかシステム構成を表現する図
http://twitter.com/#!/tk0miya/status/36083686684377088 文書テンプレートの作成 みんなが使ってるドキュメントからいいところを抽出 いろんな人から意見を聞きたい! 書くのが面倒くさくない / メンテするのにちょうどいい量 @shimizukawaを巻き込んで、まとめていきます 興味がある人は声かけてください
33.
まとめ ドキュメントは楽して楽しく書こう 自分のために。誰かのために
書いて終わりではなく、メンテできる大きさが大事 ツールややり方を工夫するとドキュメントは辛くない Excel 方眼紙はもはや化石 Sphinx は冴えた一つのやり方 もちろん blockdiag, seqdiagもね 楽するためには知恵と経験が必要 テンプレート、ツール群 知識やアイディアください (@tk0miya まで)
Baixar agora