#expertpython エキスパートPythonプログラミング読書会13

エキスパートPythonプログラミングの読書会13回目 ドキュメント作成のための戦略について。なお10章は無料配布があります -> http://sphinx-users.jp/articles/index.html#id3 相変わらず本を読まない読書会を目指したかったのですが、ドキュメントの章だけに文字での概念説明が多かったです>< 続きを読む
2
Takayuki Shimizukawa @shimizukawa

【TODAY】【エキPy読書会】 本日19:30から。 第10章 プロジェクトのドキュメント作成 p263~ 10章は無料配布ありマス http://bit.ly/96iX8E 申し込みはこちら http://atnd.org/events/16717 #expertpython

2011-06-21 17:48:00
Takayuki Shimizukawa @shimizukawa

ぼちぼち人が集まり始めたので、恒例の自己紹介から進めていきます #expertpython

2011-06-21 19:31:55
しょーま @shomah4a

( ゚∀゚)o彡゜ えきぱい! えきぱい! #expertpython

2011-06-21 19:34:22
@lunch_at_toilet

俺のアカウントがさらされてるうううう #expertpython

2011-06-21 19:41:59
KITAZAKI Shigeru @kshigeru

"ドキュメント作成は、開発者、ときにはマネージャもさぼってしまいがちな作業です。" / 10章: プロジェクトのドキュメント作成 - http://t.co/pf2y18e #expertpython

2011-06-21 19:49:58
tk0miya @tk0miya

Sphinx はいま勉強している最中です #expertpython

2011-06-21 19:55:29
tk0miya @tk0miya

( ゚∀゚)o彡゜ えぱきい! えぱきい! #expertpython

2011-06-21 20:01:08
Tetsuya Morimoto @t2y

( ゚∀゚)o彡゜ えぱきい! えぱきい! #expertpython

2011-06-21 20:01:37
KITAZAKI Shigeru @kshigeru

Q. 技術文章を書くためにどんな本を読んで勉強してる? A. ワインバーグ先生の本、日本語の作文技術、理科系の作文技術、エキPy(笑 #expertpython

2011-06-21 20:03:26
Tetsuya Morimoto @t2y

Q. Sphinx の図表番号が付くようになるのはいつ頃ですか? by @tk0miya #expertpython

2011-06-21 20:05:29
Tetsuya Morimoto @t2y

Q. Sphinx 1.1 はいつ頃リリースされそうな雰囲気ですか? #expertpython

2011-06-21 20:06:04
no root, nobody @togakushi

ドキュメントを書くときはターゲットを明確に! #expertpython

2011-06-21 20:09:32
no root, nobody @togakushi

何度も繰り返さなくて結構です。複雑な時制はいりません。現在系で十分です。ジョークを入れるのは上級者になってから。 #expertpython

2011-06-21 20:12:45
KITAZAKI Shigeru @kshigeru

タイトルが明快になれば逸脱した話題はノイズに思えてくるので、情報のスコープが絞られる。後から振り返るときにどのような検索語句を使うだろうか?と問い直してみる。たいていの検索インデクスではタイトルの重みが強いことを利用する。 #expertpython

2011-06-21 20:16:47
no root, nobody @togakushi

同じ文章でも見た目が変わると意外と間違いが見つかるよね。 #expertpython

2011-06-21 20:18:16
KITAZAKI Shigeru @kshigeru

レビューするときは見た目を変えてみる。内容を書き出すフェーズと、表示をリッチにするフェーズを分ける。「2つのステップで書く」ということ。 #expertpython

2011-06-21 20:18:49
no root, nobody @togakushi

クリップボードにコピーすると複数の MIME TYPE をまとめてコピーする。ペーストするときに受け手で適切なものを選ぶんですって! #expertpython

2011-06-21 20:20:53
no root, nobody @togakushi

「コード見れば分かるよ」と言う人のコードは読みにくい #expertpython

2011-06-21 20:27:25
DF @masterblue555

RT @togakushi: 「コード見れば分かるよ」と言う人のコードは読みにくい #expertpython

2011-06-21 20:27:53
1 ・・ 5 次へ