良いドキュメント・マ ..
[
2ch
|
▼Menu
]
■コピペモード
□
スレを通常表示
□
オプションモード
□このｽﾚｯﾄﾞのURL
■項目テキスト
9:デフォルトの名無しさん 03/10/05 23:47 ソースと双方向でできる奴なら手間もかからずいいかな。 それ以外は最終的にはソース見ろになるから、詳細レベルは不要。 設計時は通じるレベルで記述して、後は仕様書作成ツール様に任せる。 10:デフォルトの名無しさん 03/10/05 23:48 >>7 こういう話題もマ板なの？ ドキュメントを記述する上での技術的な話題とすれば、 ム板でもいい気がするけど。 11:デフォルトの名無しさん 03/10/05 23:51 >>8 会社によってフォーマットがあまりにも違うので語りようがなかったりして。 ちなみにうちは検査に出すドキュメントに決められたフォーマットはなし（笑 12:デフォルトの名無しさん 03/10/05 23:54 社内的には分からんでもないが、社外的には綺麗なドキュメント残すと次の仕事が 取り辛くなっちゃうから意図的に残さないｗ 13:デフォルトの名無しさん 03/10/05 23:54 ドキュメント書く上ではまず、ソースとの同期という問題がある。 これはソースとドキュメントが別ファイルなのが問題ではないか？ ということで、doxygenみたいなツールを使うことである程度緩和される。 ただしdoxygenはC++専用。 各言語毎にこういうツールを用意する必要がある。
次ページ
最新レス表示
スレッドの検索
類似スレ一覧
話題のニュース
おまかせリスト
▼オプションを表示
レスジャンプ
mixiチェック！
Twitterに投稿
オプション
しおりを挟む
スレッドに書込
スレッドの一覧
暇つぶし2ch
5215日前に更新/155 KB
担当:undef