良いドキュメント・マニュアル・仕様書を書くスレ
at TECH
[
2ch
|
▼Menu
]
■コピペモード
□
スレを通常表示
□
オプションモード
□このｽﾚｯﾄﾞのURL
■項目テキスト
1:デフォルトの名無しさん 03/10/05 23:34 おまえら、自分で作ったプログラムについての、わかりやすく的確な ドキュメントを書ける自信はあるか？ 仕事で納品したり、他人に見せるプログラムとして公開するつもりなら、 マニュアルや、仕様書などのドキュメントを書く機会は必ずある。 プログラムとドキュメントはとても関係が深い。ドキュメントが整っていない プログラムなど、ゴミと同じ。それに、ただ書けばいいって物でもない。 ドキュメントがゴミ程の役にも立たなければ、結局それはゴミなのだ。 だらだらと書いた意味不明な文章を他人に見られるのも恥ずかしいよな？ いわばドキュメントを書く技術はプログラマの必須スキルの１つなのだが、 実際は、下手糞なドキュメントが蔓延っている。(これはGNU製に多い) 読んでも無駄とか、書いても無駄とか思ってる奴、その考えを改めろ。 プログラムに対するドキュメントを、ちゃんとした１作品として、 後世に残せるよう努力すべきだろう。 今一度問う。 おまえら、わかりやすく的確なドキュメントを書ける自信はあるか？
次ページ
最新レス表示
スレッドの検索
類似スレ一覧
話題のニュース
おまかせリスト
▼オプションを表示
レスジャンプ
mixiチェック！
Twitterに投稿
オプション
しおりを挟む
スレッドに書込
スレッドの一覧
暇つぶし2ch
5194日前に更新/155 KB
担当:undef