- 1 名前：デフォルトの名無しさん [03/10/05 23:34]
- おまえら、自分で作ったプログラムについての、わかりやすく的確な
ドキュメントを書ける自信はあるか？
仕事で納品したり、他人に見せるプログラムとして公開するつもりなら、
マニュアルや、仕様書などのドキュメントを書く機会は必ずある。
プログラムとドキュメントはとても関係が深い。ドキュメントが整っていない
プログラムなど、ゴミと同じ。それに、ただ書けばいいって物でもない。
ドキュメントがゴミ程の役にも立たなければ、結局それはゴミなのだ。
だらだらと書いた意味不明な文章を他人に見られるのも恥ずかしいよな？
いわばドキュメントを書く技術はプログラマの必須スキルの１つなのだが、
実際は、下手糞なドキュメントが蔓延っている。(これはGNU製に多い)
読んでも無駄とか、書いても無駄とか思ってる奴、その考えを改めろ。
プログラムに対するドキュメントを、ちゃんとした１作品として、
後世に残せるよう努力すべきだろう。
今一度問う。
おまえら、わかりやすく的確なドキュメントを書ける自信はあるか？
- 458 名前：デフォルトの名無しさん mailto:sage [2007/08/13(月) 22:07:06 ]
- ソース「管理」の原則からは、ね。
でも実際に集中して作業してるときって /* */ 使わないか？
#if #endif より入力しやすいと思うんだが。
ついでに、古いコーディング規約が改定されずに使われる場合、
「VSS でチェックインするソースには原則として /**/ を含まないこと」
みたいな決まりが未だにまかり通る現場もあるんでは？（←ウチだけか？）
>> // は使うべきではない。
おまえんとこは１行コメントも #if なの？
- 459 名前：デフォルトの名無しさん mailto:sage [2007/08/13(月) 22:11:15 ]
- >>458
/**/を使ってはならないという規則で/**/でコメントアウトするのは
ナンセンスな気がするが……
もっと言うと、/**/でコメントアウトするときに障害になるから
/**/を使うなということか
あまりにナンセンスすぎて意味がよくわからないな
- 460 名前：デフォルトの名無しさん mailto:sage [2007/08/13(月) 22:24:42 ]
- >>459
こんな些細なネタで話を伸ばしたくないんだが。
/**/ は作業中のみ一時的な目的に使うべし、
チームメンバーに公開するソースからは /**/ 無くすべし、
当然使わないコードは消すべし、
一時的に残すなら #if ～ #endif を使うべし。
ということでまぁ折り合いがついてる。
それより、
>> // は使うべきではない。
> おまえんとこは１行コメントも #if なの？
についての解答が欲しい。あんまりコメント書かない習慣ってことか？
- 461 名前：459 mailto:sage [2007/08/13(月) 22:34:47 ]
- >>460
俺は上の人とは違う（はじめて書き込んだ）ので、上での話を
俺に聞かれても知らん。
俺のことを言えば、//を禁じるのも/**/を禁じるのもナンセンスにしか
思えない。
- 462 名前：デフォルトの名無しさん mailto:sage [2007/08/13(月) 22:42:06 ]
- >>461
人違いスマソ
大人しく 457 からの回答を待つよ
- 463 名前：デフォルトの名無しさん mailto:sage [2007/08/14(火) 00:37:35 ]
- 457ではないけど、コードの無効化に//を使うなって事じゃない？
//f(a, // aのコメント
//b, // bのコメント
//c) {// cのコメント
//}
/*
f(a, // aのコメント
b, // bのコメント
c) {// cのコメント
}
*/
↑つまりこんなことするなって？（こんなことするか？）
#if 0
f(a,b,c) {
}
#endif
>>458
/* */て右手だけでシフト押したりするから入力しづらくね？
手前のキー使うから爪切ってないと辛い
#if 0
#endifのが気持ち早い
- 464 名前：458 mailto:sage [2007/08/14(火) 00:58:23 ]
- >>463
が紹介したような使い方は稀だけど、無効化した理由を添えることはあるだろう。
// int i = func();
int i = func2();
// ↑×××により○○○に変更。
/* */ の入力にシフトは使わん。テンキーについてるやつを使う。
- 465 名前：デフォルトの名無しさん mailto:sage [2007/08/14(火) 02:00:54 ]
- #if で無効化しておいて理由をコメントで添えずにコミットすることを禁止すべきだろう。
- 466 名前：458 mailto:sage [2007/08/14(火) 10:24:32 ]
- ㌧ なるほど
- 467 名前：457 mailto:sage [2007/08/14(火) 11:04:13 ]
- ＞ソース管理の原則からは、不使用コードは#ifで囲ってしまうべきであり/* */や//は使うべきではない。
読み難かったかな。
不使用コードをコメントアウトする目的で、/* */や//は使うべきではないということね。
その目的で//を使うと、例えばリリース前に消したくても通常のコメントと区別がつきにくいので消し損ねかねない。
#ifならgrepでの検出も簡単だろう。
って、>465が書いているね。更には、リビジョン管理しているなら残すべき理由もないはずだが。
- 468 名前：デフォルトの名無しさん mailto:sage [2007/08/14(火) 22:41:53 ]
- a = b;
/*
c = d;
*/
e = f;
↑こうなってるときに
/*
a = b;
/*
c = d;
*/
e = f;
*/
↑あとからこんなことする馬鹿がいるからじゃね？
- 469 名前：デフォルトの名無しさん mailto:sage [2007/08/15(水) 03:51:34 ]
- >>468
誰に向けて書いたのか知らないがそれはコンパイルエラーだから論外
- 470 名前：デフォルトの名無しさん [2007/08/18(土) 03:26:18 ]
- >>468程度でも見難いと思う程度の脳味噌ですが…
- 471 名前：デフォルトの名無しさん mailto:sage [2007/08/22(水) 00:13:17 ]
- /* */ とか #if #endif でコメントアウトされてると、grepでコードを引っかけたときに、
それが使われているコードなのかコメント化されているコードなのかがgrepの結果からだけでは分からない。
てなわけでうちでは // だけ使うことになってる。
- 472 名前：デフォルトの名無しさん mailto:sage [2007/08/22(水) 11:30:55 ]
- >>471
だからこそ、リリース版のソースにコメントアウトされたコードを残してはいけないのです。
- 473 名前：デフォルトの名無しさん mailto:sage [2007/08/23(木) 01:19:20 ]
- 当社では、コードを修正する際に修正前のコードをコメントアウトしてソースに残しておくことが
規則で定められてるんだけど、もしかしてレア？
- 474 名前：デフォルトの名無しさん mailto:sage [2007/08/23(木) 01:22:00 ]
- ＳＶＮとかＣＶＳとかは？
- 475 名前：デフォルトの名無しさん mailto:sage [2007/08/23(木) 01:50:24 ]
- >>473
いや。よくある糞規則。
- 476 名前：デフォルトの名無しさん mailto:sage [2007/08/23(木) 05:59:57 ]
- 最悪だな
- 477 名前：デフォルトの名無しさん mailto:sage [2007/08/24(金) 01:10:24 ]
- >>473ごく普通のことです…orzｷﾀﾈｰ
- 478 名前：デフォルトの名無しさん mailto:sage [2007/08/24(金) 10:56:27 ]
- まさか、コメントアウトされた行も含めて行数で金取ってたりしないよな。
- 479 名前：デフォルトの名無しさん mailto:sage [2007/08/24(金) 11:33:09 ]
- 行数で計算して金をとってる所なんてあるの？見たこと無い。COBOLとか？
- 480 名前：デフォルトの名無しさん mailto:sage [2007/08/24(金) 11:46:27 ]
- >>479
Cでも未だあるらしいよ。
- 481 名前：デフォルトの名無しさん mailto:sage [2007/08/24(金) 22:18:51 ]
- 目安としてステップ数はなくても、n万行のコードって今でも言うでしょ。
- 482 名前：デフォルトの名無しさん mailto:sage [2007/08/24(金) 22:45:51 ]
- 言わない
- 483 名前：デフォルトの名無しさん mailto:sage [2007/08/25(土) 14:35:46 ]
- 某上場企業のシステムのリメイクを請け負ったけど
元のがループ使わずコピペでシコシコ行数稼いでいるプログラムがあった
マジで
- 484 名前：デフォルトの名無しさん mailto:sage [2007/09/03(月) 22:19:04 ]
- >>479
F痛
- 485 名前：デフォルトの名無しさん mailto:sage [2007/09/04(火) 07:28:56 ]
- テンプレートとかgenericsは敵だな。型の分だけ、コード増やせない。
- 486 名前：デフォルトの名無しさん [2007/10/27(土) 18:26:59 ]
- Doxygen 1.5.4 age
- 487 名前：デフォルトの名無しさん [2007/10/28(日) 13:23:14 ]
- よく、日本人は罫線をやたらと使いたがるって話があって、
たしかに、excelで、罫線使いまくったドキュメントって書くのが面倒なんだけど、
かといって、日本式のそういうドキュメントしか見たことないから、罫線なしで
かっこいいドキュメントというのが想像できません。
外国で使われてるドキュメントのサンプルみたいのを見れるところってありませんかね。
- 488 名前：デフォルトの名無しさん mailto:sage [2007/10/28(日) 20:18:16 ]
- >>487
米のミドルウェアをいくつも使ったけど、そのへんのオープンソースのよりもショボい感じ。
オープンソースのをいくつも見ればいいと思うよ。
- 489 名前：デフォルトの名無しさん mailto:sage [2007/10/29(月) 01:30:01 ]
- HTMLヘルプで十分て気がする
表示ソフトいらないし、ファイル1個で済むし
*NIXで見れない？
知 る か
- 490 名前：デフォルトの名無しさん mailto:sage [2007/10/29(月) 02:08:39 ]
- >489
つttp://xchm.sourceforge.net/
- 491 名前：デフォルトの名無しさん mailto:sage [2007/10/29(月) 12:29:28 ]
- >>487
罫線を使わないこととExcelを使わないことはイコールではないよ。
喩えて言えば、○×をやるのに周りを囲むか(囲こんな形)か、囲まないか(井こんな形)の違い。
- 492 名前：デフォルトの名無しさん mailto:sage [2007/12/08(土) 03:09:44 ]
- doxygenで更新履歴をいじった関数に書いて、
todoリストみたいにまとめたいなと思って調べたら、
\xrefitemを使えばオリジナルの\todoができることは、わかったのですが、
関連ページ追加される項目を日付ごとにまとめて並べること方法ないでしょうか?
- 493 名前：492 mailto:sage [2007/12/10(月) 02:14:40 ]
- 以下のようにしてみました。
ALIASES += "history{1}=\xrefitem histories\1 \"更新履歴(\1)\" \"更新履歴(\1)\""
日付でソートできていないし、日付ごとに別ファイルになってしまいます。orz
もっとよい方法は無いでしょうか?
- 494 名前：デフォルトの名無しさん mailto:sage [2007/12/30(日) 02:14:53 ]
- ドキュメント管理が破たんしてる業務システムの保守をやってるんだが、
・機能ごとに、仕様書があったりなかったり
・管理がずさんで、どのファイルが本物の仕様書かわからなかったり
・仕様書が現状の実装と同期がとれてなさそうだったり
てな具合。
で、どうにかせにゃアカンってことで、取り急ぎコード修正・保守作業に
最低限必要なドキュメントだけ、リバースエンジニアリングして書き起こしてる
とこなんだが、作った後の維持管理って、みんなどんな感じでやってる？
- 495 名前：デフォルトの名無しさん mailto:sage [2007/12/30(日) 11:15:07 ]
- ソースと同じくCVS管理
- 496 名前：デフォルトの名無しさん mailto:sage [2007/12/30(日) 17:27:36 ]
- 市役所の情報システム部門に勤務している人って居る？
- 497 名前：デフォルトの名無しさん mailto:sage [2008/01/02(水) 20:27:53 ]
- 市役所のシステム部門つっても、市職員がいる「○○市情報××課」みたいな
市役所ネイティブの部署と、運用を委託されてる会社の人が常駐している実務
部隊の２通り取り方があるわけだがどっち？
- 498 名前：デフォルトの名無しさん [2008/01/09(水) 12:59:45 ]
- DOXYGENだが、1.5.2以降、内部ユニコード処理になって、入力ファイルと
出力ファイルのエンコード指定ができるようになっているのはいいんだ
けど、言語とエンコードの指定に関係なく生成されたHTMLのヘッダ部分
は、「charset=UTF-8"」なんだが、ガイシュツ？
ブラウザ側のエンコード自動識別のおかげでHTMLドキュメントはうまく
表示できるが、HTML Help CompilerでHTML Helpファイルに変換すると、
インデックス部分の日本語が化ける。
- 499 名前：デフォルトの名無しさん mailto:sage [2008/01/09(水) 16:53:47 ]
- 生成されたindex.hhcのエンコーディングをUTF-8からCP932(ShiftJIS)に変換して、
hhc.exe index.hhpでおｋ
- 500 名前：498 [2008/01/09(水) 19:45:11 ]
- >>499
それじゃあ、ツールを使って自動化する意味ないじゃん。
他にも、index.hhpでのフォント指定やら変で、特に1.5.x以降を使う
メリットが見当たらないので、結局1.4.7に戻した。1.4.7は、Japanese
選択しとくと、「charset="SHIFT_JIS"」になる。
HTML Help をコンパイルする前にフォントを変更しても、Doxygenで生成
されるソースコードのページのフォントが変なんだよね。どうもアルファ
ベット部分だけ、無条件にArialになってるっぽい。
- 501 名前：499 mailto:sage [2008/01/10(木) 02:54:40 ]
- 自分はHTMLとPDFを生成できるようにnmake用のMakefile作って自動化してるんだが。
ツール側の対応に頼るのもいいけどさ。
- 502 名前：デフォルトの名無しさん [2008/01/10(木) 06:10:22 ]
- すいません、あるWindowsアプリ(制御系)のドキュメントを
作成するよう指示がありました。
ちなみに開発環境はTurboC++。
C++の知識レベルは、入門書１冊読んだ程度。（アプリ開発経験なし）
Doxygen使ってみたのですが、Doxygen対応コメントで作成されてないので
クラス階層とか関数呼出などの図ではイメージできるのですが、
コメントがないので、やってることがさっぱりわかりません。
そういう場合は、やはり、ソース解読しながら、
Doxygen対応コメントをひたすら打ち込むことから始めるべき
なのでしょうか？
- 503 名前：デフォルトの名無しさん mailto:sage [2008/01/10(木) 07:58:38 ]
- アプリのなんだからDoxygen関係ないじゃん
- 504 名前：デフォルトの名無しさん mailto:sage [2008/01/11(金) 14:48:40 ]
- Doxygen用のコメントを作るには、ある程度解析が必要だから方針としては悪くないと思うよ。
でも、そこで要求されている「アプリのドキュメント」はDoxygenの出力でいいの?
通常はその括りだと基本仕様か機能仕様に類する資料が必要になってくると思うのだけど。
- 505 名前：デフォルトの名無しさん [2008/02/10(日) 21:43:34 ]
- Doxygen 1.5.5 release age
- 506 名前：デフォルトの名無しさん [2008/02/11(月) 11:45:18 ]
- Doxygen 1.5.6 release age
- 507 名前：デフォルトの名無しさん mailto:sage [2008/02/11(月) 12:09:51 ]
- ちょっとまて
ここはDoxygenスレじゃないんだぜ
- 508 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 14:02:50 ]
- だからといってDoxygen等の各ツール専用スレを建てると
このスレもそのスレも今まで以上に過疎るからやめてほしいぜ
- 509 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 14:42:19 ]
- いや個々のツールの使い方はかなり無関係だろこのスレ
- 510 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 14:47:10 ]
- 保守代わりってことでいいと思う
- 511 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 15:06:37 ]
- 一ヶ月も放置されてたスレに、自分の意にそぐわないレスが二つ付いただけで
噛み付く奴って何なの？
- 512 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 15:33:25 ]
- 問題は時系列ではなく内容である
「1ヶ月ぶりのレスだから何書いても許す」というほうが不条理
- 513 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 15:35:41 ]
- 不条理もへったくれもないだろ。スレ違いと言うほど外れた内容じゃないんだから。
敢えて>509の言うように「個々のツールの使い方」は無関係だとしても、「個々のツールの情報」は無関係じゃないだろ。
- 514 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 15:46:47 ]
- >>512
何書いても許すなんて言ってないだろ、ボケ
「お前の意に沿わないレス」で噛み付くなって言ってんだ
- 515 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 16:05:15 ]
- お前の意に沿わない「お前の意に沿わないレス」へのレスに
噛み付くなともいへり。
- 516 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 16:06:10 ]
- すまん、あまり面白くなかった。
- 517 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 16:15:09 ]
- よし、いいぞもっとやれ、もっと罵りあえ！
いいですか、↑これがどうしようもないレスという物の見本です
- 518 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 16:17:58 ]
- まあ久しぶりににぎわってよかった。
↑これはどうかな。優等生過ぎてどうしようもない？
- 519 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 22:50:57 ]
- ﾄﾞｷｭﾒﾝﾄ書くのﾒﾝﾄﾞｸｾｪ・・・
そもそも何を書いていいのか分からんのだよ
- 520 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 23:44:47 ]
- >>519
大丈夫だ。どうせ誰も見ない。
ぐらいの気持ちで書いてまつ。
本当に皆が必要な内容ならそんな悩まなくても書けるよ。
- 521 名前：デフォルトの名無しさん mailto:sage [2008/02/13(水) 01:27:10 ]
- 「～したら期待したとおりにうごかねーぞｺﾞﾙｧ」ときた時に
「ドキュメントは読みましたか？ﾌﾌﾝ」とするために書く。
- 522 名前：デフォルトの名無しさん mailto:sage [2008/02/13(水) 23:08:46 ]
- ソースコードにドキュメント付けするときには、
とりあえず日付を真っ先に書くようにしている。
ほかの文章は後からでも書けるけど、
こればっかりは後から思い出そうとしても思い出せない。
- 523 名前：デフォルトの名無しさん mailto:sage [2008/02/15(金) 15:13:16 ]
- 書いてすぐコミットしようよ・・・
- 524 名前：デフォルトの名無しさん mailto:sage [2008/02/16(土) 12:59:06 ]
- >>522
ついでに天気とその日の主な事件も書いとけ
- 525 名前：デフォルトの名無しさん [2008/02/26(火) 20:56:32 ]
- source code に含まれないドキュメントに数学記号使った数式を
書いたら怒られたんだが, なぜ?
- 526 名前：デフォルトの名無しさん mailto:sage [2008/02/26(火) 23:47:14 ]
- >>525
理由も聞かなかったのか？馬鹿
- 527 名前：デフォルトの名無しさん mailto:sage [2008/02/27(水) 00:17:20 ]
- >>526 意味がわからんとゆわれた
- 528 名前：デフォルトの名無しさん mailto:sage [2008/02/27(水) 00:26:10 ]
- プログラマなら常識ですと言ってやりたいなｗｗｗｗ
- 529 名前：デフォルトの名無しさん mailto:sage [2008/02/27(水) 00:26:46 ]
- >>527の意味もわからんわ馬鹿
- 530 名前：デフォルトの名無しさん [2008/02/27(水) 15:40:49 ]
- >>437
俺も重複を避ける為にそう思った。
が、この文法では、@param属性(入力,出力、入出力)が付けられない。これは痛い。
従って、@paramを使わざるをえなかった。
//445
ダメだよ、それじゃ。パッと見でもおかしいし、実際 変な表示になるよ。
- 531 名前：デフォルトの名無しさん [2008/03/05(水) 23:50:08 ]
- マニュアル・手順書を作るのに、使うのはWord？Excel？
俺はExcel派。
Word使うヤツの気が知れない。
要するに、あとで文章直すときに改行がExcelだと
大変だってだけの話でしょ？
レイアウトは断然Excel優位だよね。
- 532 名前：デフォルトの名無しさん mailto:sage [2008/03/05(水) 23:52:51 ]
- まだEXCEL使い奴いるんだな
- 533 名前：デフォルトの名無しさん mailto:sage [2008/03/06(木) 09:04:30 ]
- つられませんから。
でもスタイル指定しないWordはひょっとしたら
確かにExcelよりクソかもしれない。
- 534 名前：デフォルトの名無しさん mailto:sage [2008/03/06(木) 16:21:43 ]
- まあ、Excelの方が向いてるドキュメントはあるわな。
- 535 名前：デフォルトの名無しさん [2008/03/07(金) 01:26:50 ]
- >>531
> マニュアル・手順書
にかぎるんだったら, エディタで書いた平テキスト
エンドユーザー向けのマニュアルは別部門が作る
図面ほしいって言われたら、CAD 図面
# 新規ハード使う組み込み系の仕事がほとんどだが
- 536 名前：デフォルトの名無しさん mailto:sage [2008/03/12(水) 18:34:18 ]
- ここはdoxygenスレじゃない事は分かっているのですが・・・ちょっと質問。
関数仕様書を作るのにdoxygenを使おうとしています。 ver1.5.5を使っている
のですが、HTML出力は上手くいくものの、rtf出力になるとUTF-8でエンコード
されていて、テキストエディタでは日本語が読めるのですが、Wordやワードパッド
では文字化けして読めません。これではRTF出力する意味がありません。
DoxyWizardでは出力、入力ともShift-JISに設定しているのですが・・・(当然、
ソースのコメントはShift-JISです)
一体何がいけないのでしょうか？
- 537 名前：デフォルトの名無しさん mailto:sage [2008/03/12(水) 21:54:59 ]
- SHIFT-JIS
↓
SHIFT_JIS
- 538 名前：536 mailto:sage [2008/03/13(木) 09:27:00 ]
- SHIFT_JISにはなっていました。エンコード設定の所にカーソル合わせると
「gnuのlibiconv使ってるからそこのページ見ろや」みたいな表示が出るので
そこを見てコピペしたからだと思います。
HTMLはちゃんと表示出来るのにRTFがダメなのが良く分かりません。
- 539 名前：デフォルトの名無しさん mailto:sage [2008/03/13(木) 13:50:29 ]
- CP932は試した？
- 540 名前：536 mailto:sage [2008/03/14(金) 18:08:47 ]
- CP932でもダメのようです。
どうも、エンコード方式を指定するバージョンでは全てダメのようで。
具体的には1.5.2からはダメ。
仕方ないので1.5.1以前を使おうかと思います。ソースいじってなんとかする
スキルはないし。
あと、ついでにもう気づいた事。@paramコマンドで[in][out]表示が出来ますが、
HTMLでは問題ないものの、RTFでは何故か表示できません。
なぜRTFにこだわるかと言うと、提出物としてはHTMLよりもWord文書の方が良い
のではないかという事です。RTFならそのままwordで読めるし、DOCに直すにしても
ほとんど手直しの必要がないですからね。
まぁ、Word出力するなら商用ツール使えって事なのかなぁ・・・でも、ウチの会社
そんなに余裕ないし。
- 541 名前：デフォルトの名無しさん mailto:sage [2008/03/14(金) 20:30:26 ]
- defaultcharsetと合ってないor設定されていないんじゃないかな
- 542 名前：デフォルトの名無しさん mailto:sage [2008/03/24(月) 11:25:04 ]
- >>536
うちじゃどうしても日本語が必要なときはTeXで出して、pdfに落として提出した。
そうでないときは、全部英語にしておいた。
そうか、1.5.1ならRTFに日本語を出せたのか……
- 543 名前：デフォルトの名無しさん mailto:sage [2008/04/07(月) 23:38:23 ]
- ソースにdoxygenのコメントのテンプレートを挿入してくれるツールって無いですか？
たとえば
int f(int x)
{
…
}
というソースがあったら
/*!
*
* @param x
* @return
*/
int func(int x)
{
…
}
のような感じでコメントを挿入してくれるとありがたいです。
- 544 名前：デフォルトの名無しさん mailto:sage [2008/04/12(土) 21:56:16 ]
- >>543
よし、売ろう
- 545 名前：デフォルトの名無しさん mailto:sage [2008/04/13(日) 16:41:20 ]
- >>543
Visual Studioでの開発ならマクロ組めば出来るんじゃないかな
- 546 名前：デフォルトの名無しさん [2008/04/28(月) 19:31:50 ]
- ネットワークプロトコル説明するのに、状態遷移図書いて提出したら
「意味がわからん！！！ 書き直してこい！！！」
と言われてしまったんだが、おまえらどうやって説明してますか？
# 一応、説明文は遷移図一枚につき5ページくらいは書いたんだが…
- 547 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 19:34:27 ]
- >>546
＞# 一応、説明文は遷移図一枚につき5ページくらいは書いたんだが…
説明文をだらだらと長く書きすぎたんじゃない？
- 548 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 19:42:13 ]
- だったら図だけで分かってほしかったよorz
これじゃわからんって言うから、書き足していったらこうなった
どう説明すりゃいいんだ？
縦線ひいて斜め矢印か？
例外だらけになるやないか！！！
- 549 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 19:46:17 ]
- >>548
怒られたのに何がダメだったのか聞いてはないの？
- 550 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 19:50:19 ]
- >>548
箇条書きにした？
- 551 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 19:51:26 ]
- >>549
もっと詳しく書けっていったから詳しく書いたんだが、ついでに数式まで交えて…
「例をだせや！！！」っても、「はじめてなんでありません」と…
- 552 名前：デフォルトの名無しさん [2008/04/28(月) 19:52:27 ]
- >>545
そういえば、VSってソース解析する上にマクロからアクセスできるんだったな。
ドキュメント自動生成マクロなんかあってもよさそうなのにな。
何とか工房がそうなのか？
- 553 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 20:10:39 ]
- >>551
相手が理解できない点を、推測じゃなくて、ちゃんとヒアリングするのは無理なのか?
あと、説明するときは、いきなり本物じゃなくて、ミニマムセットで理解できるかどうか確認するとか。
そこらへんにギャップがあると、「それじゃわからん」vs「ではどう書けと」の対決になるような希ガス。
- 554 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 21:32:33 ]
- プロトコルなんだから、シーケンス図？（自分対相手でメッセージを線で表現した奴）も
必要なんじゃない？
- 555 名前：デフォルトの名無しさん [2008/04/28(月) 22:06:01 ]
- 自分<-- メッセージ -->相手
こうかｗ
- 556 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 23:24:10 ]
- 通信プロトコルならシーケンス図がいいんじゃないか？
状態遷移図と突き合わせできるように書けばOK
- 557 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 23:33:37 ]
- >>556
しかし、シーケンス図だと条件分岐がすごく書きにくくない?
- 558 名前：デフォルトの名無しさん mailto:sage [2008/04/29(火) 01:20:36 ]
- パターン別に何種類か書いたらよかろうが
|
 |
