- 1 名前：デフォルトの名無しさん [03/10/05 23:34]
- おまえら、自分で作ったプログラムについての、わかりやすく的確な
ドキュメントを書ける自信はあるか？
仕事で納品したり、他人に見せるプログラムとして公開するつもりなら、
マニュアルや、仕様書などのドキュメントを書く機会は必ずある。
プログラムとドキュメントはとても関係が深い。ドキュメントが整っていない
プログラムなど、ゴミと同じ。それに、ただ書けばいいって物でもない。
ドキュメントがゴミ程の役にも立たなければ、結局それはゴミなのだ。
だらだらと書いた意味不明な文章を他人に見られるのも恥ずかしいよな？
いわばドキュメントを書く技術はプログラマの必須スキルの１つなのだが、
実際は、下手糞なドキュメントが蔓延っている。(これはGNU製に多い)
読んでも無駄とか、書いても無駄とか思ってる奴、その考えを改めろ。
プログラムに対するドキュメントを、ちゃんとした１作品として、
後世に残せるよう努力すべきだろう。
今一度問う。
おまえら、わかりやすく的確なドキュメントを書ける自信はあるか？
- 51 名前：デフォルトの名無しさん mailto:sage [03/10/14 23:37]
- J#とJavaでJavaはすでに両方で動いてますね。
- 52 名前：デフォルトの名無しさん [03/10/15 01:12]
- C#もJVMで動くのかな？
- 53 名前：デフォルトの名無しさん mailto:sage [03/10/15 01:21]
- >>51
ライブラリが違いすぎ。
言語仕様なんてライブラリに比べたら問題にならないでしょ。
- 54 名前：デフォルトの名無しさん [03/10/15 01:22]
- どうせクラス仕様書なんか作っても、素人の客は理解なんかできないだろ。
適当でいいんだよ。
- 55 名前：デフォルトの名無しさん mailto:sage [03/10/16 03:25]
- 少なくともJavaで書かれたソースコードは、これは「ソフトウェア」じゃ
ない。「ダイアモンドウェア」であってハードウェアよりもず〜っと硬い。
これを現実のハードに適用するとどういう結果を招くか。つまりJavaで
書かれたソースはあくまでも実装準備段階で、別にもう一度ソース最初から
書き直さなければならないってことね。真に良いソフトウェアを書く為には
ダイアモンドのように硬いソースが必要だったりすることもあるから
Javaの存在価値はMSが言うほど小さいものではなかったりする。
ただしそれは十分に柔らく書き直してから使うべきだろうけどね。
- 56 名前：デフォルトの名無しさん mailto:sage [03/10/16 03:32]
- 誰か>>55を日本語に直してくれ。
- 57 名前：デフォルトの名無しさん mailto:sage [03/10/16 11:54]
- >>56
>>55をexcite翻訳を使って英訳、
できなかった部分は原文を意味が変わらない程度にいじって再び英訳、
そしてそれを邦訳。結果はこれ。
Javaによって少なくとも書かれたソース・コードについては、
これが「ソフトウェア」にあります。何もありません。
それは「ダイヤモンドの着用」で、ハードウェアよりはるかに困難です。
これが応用の困難な[現実]である場合、
どんな結果が引き起こされるでしょうか。
で、すなわち、書かれたソースがそうであるJava、
最後への増大する準備段階でもう一度独立して始まるソースから。
書き直しに対して持っています。
ハードソースがダイヤモンドのように時々要求されるので、
非常によいソフトウェアを書くために、
Javaの存在価値はMSが言うほど小さくありません。
しかしながら、それは十分に柔らかに書き直した後に使用されるべきですか。
- 58 名前：デフォルトの名無しさん [03/10/16 14:41]
- ようするに、スクリプトを作って、スクリプトの解説を書いておけば
あとはスクリプトが仕様書って事かい？
- 59 名前：デフォルトの名無しさん [03/10/16 17:27]
- 仕様書は書いたって誰も読まないから、嘘が書いてなければいい。
保守するときだって仕様書なんか信用しない。
「地図と土地が一致していなければ必ず土地の方を信用しろ」の格言のとおり、
「ソースと仕様書一致していなければ必ずソースの方を信用しろ」なんだ。
仕様書がいくら立派でも、保守不能な（保守が現実的でない）ソースは
保守不能なんだ。
- 60 名前：デフォルトの名無しさん mailto:age [03/10/16 17:37]
- 人権尊重の個人主義社会（都会的自由人） ⇔ Ａ型中心の集団主義的村社会（封建的田舎人）
相容れない？
集団主義社会＝北朝鮮、戦前の日本。
www.pref.aichi.jp/jinken/century01.html
「人権の世紀」という言葉を聞いたことがありますか？
労働相談・ご意見
www.jtuc-rengo.or.jp/new/sodan/mail/rodo_sodan.html
- 61 名前：デフォルトの名無しさん mailto:age [03/10/16 17:37]
- ＜血液型Ａ型の一般的な特徴（改訂版）＞（「自分だけいい子」は直そう！）
●とにかく臆病・神経質で気が小さいだけ（真に他人を思いやる気持ちには欠けている、二言目には「世間」(「世間」と言っても、一部のＡ型を中心とした一部の人間の動向に過ぎない））。
●異常に他人に干渉して自分たちの古いシキタリを押し付け、そこから少しでも外れる奴に対しては好戦的でファイト満々な態度をとり、かなりキモイ（偏狭、自己中心、硬直的でデリカシーがない）。
●妙に気位が高く、自分が馬鹿にされるとカッと怒るくせに平気で他人を馬鹿にしようとする（ただし、相手を表面的・形式的にしか判断できず(早合点・誤解の名人)、内面的・実質的には負けていることが多い）。
●基本的に悲観主義でマイナス思考なため性格が鬱陶しい（根暗・陰気)。
●とにかく否定的でうざく、粗探しだけは名人級（例え10の長所があっても褒めることをせず、たった１つの欠点を見つけては貶す）。
●社会的強者には平身低頭だが、社会的弱者に対しては八つ当たり等していじめる（強い者にはへつらい、弱い者に対してはいじめる(人が見ていないときは、より一層））。
●少数派の異質・異文化を理解しようとせず、あるいは理解を示さず、排斥する(多数派＝正しい と信じて疑わない、了見が狭い差別主義者）。
●何でも「右へ習え」で、単独では何もできない（群れでしか行動できないヘタレ）。そのくせ、集団によるいじめのリーダーとなり皆を先導する（陰湿かつ陰険で狡猾）。
●他人の悪口・陰口を非常に好むと同時に、自分は他人からどう見られているか、人の目を異常に気にする（自分がウソツキだから他人のことも容易に信用できない、ポーズだけで中身を伴っていない）。
●友人関係は、表面的な浅い付き合いでしかなく、心の友はおらず孤独（他人の痛みがわからず、包容力がなく、冷酷だから）。
●頭が硬く融通が利かないため、すぐにストレスを溜め、また短気で、すぐに爆発させる（不合理な馬鹿）。
●後で自分の誤りに気づいた場合でも、素直に謝れず強引に筋を通そうとし、こじつけの言い訳ばかりする（社会悪の根源、もう腹を切るしかないだろう！)。
●男は、女々しいあるいは女の腐ったみたいな考え(例：「あいつより俺のほうが男前やのに、なんでやねん！（あいつの足を引っ張ってやる！！）」）。
- 62 名前：デフォルトの名無しさん mailto:sage [03/10/16 17:51]
- 仕様書候補と実装ソースは互いに尊重しあって、相互にそれを修正し
ていって成長するもの。仕様書候補を書こうというものは実装ソース
を書く人のニーズを真に理解していなければならないし、実装者も
仕様書候補の行間を読んで真に必要とされているものを生かしていか
なければならない。
最初に完成された仕様書があって環境毎に異なるバリエーションを持
ちえるプログラムコードはそれに従属し翻訳されたものであるという
考え方は最終的な結果論であり理想論。
というか、その状態になって初めて「仮想原本」たる仕様書と呼べる
水準のものになる。この仕様書の価値こそが極めて高いわけで、これ
が生まれることをほのかに期待するからこそ人はプログラムという邪
道に敢えて入り込むわけ。
ダイヤモンドを散りばめた服が、決して服の究極の代表的な姿にはな
りえないのと同じように、ソフトウェアも硬く鋭く光る部品で構成
されているものが終局的な姿だというわけでもないだろうね。
ま、一度その方向に極端化してみる（洗練と人は言う）というのはそ
れはそれでいて得られるものは大きく貴重なものも多いのだろうが。
- 63 名前：デフォルトの名無しさん mailto:sage [03/10/16 18:26]
- ↑文章が下手糞では説得力も糞もない
- 64 名前：デフォルトの名無しさん mailto:sage [03/10/16 23:03]
- >>62
ちゅーか、ながい。
沢村の友達なんだ炉。
- 65 名前：デフォルトの名無しさん [03/10/16 23:18]
- >>62は>>55だろ
- 66 名前：デフォルトの名無しさん mailto:sage [03/10/16 23:26]
- ダイヤモンド大好きっ子ですね
- 67 名前：(゜Jし゜） mailto:sage [03/10/16 23:27]
- ソースとドキュメントの一致と言う意味では、詳細設計レベルでは
JavaDocみたいなのを使うのが一番だよね。
概要設計レベルならUMLになるのかな？
でも、どっちも理解してくれないウチのPM…
まぁ何を書いても突っ返される訳だが（工数稼ぎのため？）
- 68 名前：デフォルトの名無しさん [03/10/17 02:15]
- doxygen とかで（規約かなんかで）全ての関数インターフェースに
コメントをつけるとしたとき、仮引数名がその意味を完全に表していたときは
１．書かない
→UNDOCUMENTEDの警告がいつも出てしまってほかの警告が霞んでしまう
２．繰り返す：@param instance インスタンス
→かっこわるい
３．空にする：@param instance
→まちがってる気がする
どれがいいんでしょうか？
- 69 名前：デフォルトの名無しさん mailto:sage [03/10/17 06:49]
- 「XXXのインスタンス」とか書くのはだめなの？
- 70 名前：デフォルトの名無しさん mailto:sage [03/10/17 10:40]
- >>68
2
- 71 名前：デフォルトの名無しさん mailto:sage [03/10/17 10:58]
- >>68
４．決めうち：@param instance ソース嫁
- 72 名前：デフォルトの名無しさん mailto:sage [03/10/17 20:37]
- ドキュメント：
自分たちが書くべき言語で書かれた文書のこと。
それを読んで次の工程の人がその人たちが書くべき言語でコードを書く。
C言語で書かれたドキュメントをコンパイラに渡してそれを参考に
アセンブリコード或いは機械語コードに変換する作業をコンパイルと呼び
その作業をする人或いはソフトウェアをコンパイラと呼ぶ。
ソース：自分たちよりも前の工程の人が書いたドキュメント群のことを区別
する為にソースと呼ぶことが多い。
Javaでドキュメントを書いている人たちも、日本語のソースや英語のソース
を読んで書いている場合が多い。多くの場合、それは既にオンライン化され
ている場合が多く、Word・Excel等の上で読めるものであったりすることが多
い。
コード：自分たちの次以降の工程の人が書く文書はコードと呼ぶ。
- 73 名前：デフォルトの名無しさん [03/10/18 23:25]
- 良いドキュメント・マニュアル・仕様書は、
良い会社・環境・人間関係という土台があってこそ
（続きどうぞ
- 74 名前：デフォルトの名無しさん [03/10/19 05:22]
- ●●●マスコミの 「盗聴／盗撮」 は許されるの？その５●●● natto.2ch.net/mass/kako/998/998142751.html
724 名前： 文責：名無しさん 投稿日： 01/09/09 17:52 ID:Na9tEsUs
>>722
＞早朝番組の「占いコーナー」なんて、個人向けメッセージの宝庫かもしれないですね。
雑誌の占い欄もそうですね、以前も書いたけど。
「あなたの成果を横取りする人がでてくるかもしれません。その人の要領の良さに嫉妬しないで」
というアドバイスをある占いから頂きました。でも残念ながら，盗聴の要領の良さは嫉妬の対象になりません。
それに、成果を横取りするよりも、私にとっては、私生活の侵害のほうが遥かに腹立たしいです。
> 口では「マスコミの盗聴」に反対しながら、本音の部分では喜んでるんだろ、と思っている。
だから、盗聴に対する罪悪感がないのだ。その根底にあるのは、
女子アナ・芸能人というものに特別の価値があるという自惚れだ。
あはは、なるほど。そう言えば、盗聴やストーキング行為は、
かっこいい人にならされてもいいと言った、某マスコミ関係者がいたらしい。
された事ないから、わからないんだよね。それを聞いた人が
「なんだ、盗聴されても悪い気はしないんだ」と思い、罪悪感無く盗聴を続ける事になる。
いくら尊敬している人でも、かっこよくても（笑 盗聴がわかった時点で、信用は無くなります。
- 75 名前：デフォルトの名無しさん mailto:sage [03/10/19 06:21]
- ♥
- 76 名前：デフォルトの名無しさん [03/10/21 01:17]
- えーと、仕様書ってのは客に見せるもんなのか
客が読んで役に立つのは要求仕様と運用マニュアルでは･･･
つーか、運用マニュアルって作んないのか･･･
- 77 名前：デフォルトの名無しさん mailto:sage [03/10/21 07:57]
- 俺もそう思う、実際見てくれたことないし。
仕様書ってのは何年後かに変更が発生した場合
自分たち（もしくはその修正を行う別会社）がどういう仕様か
確認するものだとおもてるよ
- 78 名前：デフォルトの名無しさん mailto:sage [03/10/21 17:33]
- 何年後っておまえ・・
- 79 名前：デフォルトの名無しさん mailto:sage [03/10/21 22:25]
-
このスレの文章読みづらいにだけど。
- 80 名前：デフォルトの名無しさん mailto:sage [03/10/21 22:51]
- その「読みズラい」って意見は、79の主観かもしれないよな
ハゲ！
- 81 名前：デフォルトの名無しさん [03/10/25 00:03]
- 『実践！システムドキュメント徹底活用』かってきたよage
- 82 名前：デフォルトの名無しさん [03/10/25 02:04]
- 設計者としてのドキュメント作成技法について書かれた本で
お勧めはありますか？
- 83 名前：デフォルトの名無しさん [03/10/25 02:14]
- つーか、ドキュメントは二の次だ、うごくもんつくれよ。
- 84 名前：デフォルトの名無しさん [03/10/25 02:28]
- >> ソース＝ドキュメント
>> とか言うやつはアホだな。
・・と俺もかつては思っていた、が、ソースコードこそ唯一信頼ができる詳細設計書仕様書だと思うのだ
ＰＧはそれを理解して、可視性の高いソースコードをかかなければならない。
ここでも言われているが、関数仕様書等はdoxygen等でソースから自動抽出が最も実装との差異発生率が少なくて良い
フレームワークや外部仕様リンクの仕様もできればソースに組み込めればベストだと思うが
そのようなツールは現在この世にはない。
従って、クラス図とユースケース程度のものは、自前でドキュメントを残すべきだろう
ドキュメントを大げさにするのはコストの無駄である
ドキュメント作成にコストをかけた分だけ、また、メンテナンス時のコストが発生する。
また、次第に実装との差異が増加する率が高まるだけだ。
- 85 名前：デフォルトの名無しさん mailto:sage [03/10/25 09:35]
- ソースコードをハイパーテキスト化しよう。
- 86 名前：(゜Jし゜） mailto:sage [03/10/25 10:36]
- で、ドキュメント作成する時間を取れなかったので、
コメントに詳細仕様を記述しておいたので、後で暇人を
使ってコメントから仕様書を起草しましょう、と言ったところ、
「結局、ソースを読め！かよ。これだからPGは自分勝手な…」
「ドキュメントきちんと作って…困るんだよねぇ…云々｣
PMさん…コメントと自動生成のリファレンスだけでいいんです…。
ほんとに仕様書書く時間無いんですよ、助けてください。
- 87 名前：デフォルトの名無しさん mailto:sage [03/10/25 12:19]
- そのＰＭにケント・ベックの本でもプレゼントして差し上げましょう。
「今時不勉強なＰＭは生き残れませんよ」って。
- 88 名前：デフォルトの名無しさん mailto:sage [03/10/25 13:07]
- ケント・ベックは、要求されるなら仕様書書けっていってるぞ。
- 89 名前：デフォルトの名無しさん mailto:sage [03/10/25 13:08]
- doxygenで任意の単語にリンク張りたいんだけど、
\anchorや\refいっこいっこ付ける方法しかないですか？
- 90 名前：デフォルトの名無しさん mailto:sage [03/10/25 16:14]
- 設計書と一言で言っても分野や会社によってルールも書き方もまちまちとは思う。書く場合も書かない場合もあるだろう。
本質的には「どんな書類」が「いつ・どの期間」「誰に対して」必要なのかを明確にしておく必要があると思うのだ。
・外部仕様書
大抵の職業PG,SEはある程度規模が大きいソフトウェアを作るだろうから，少なくともマニュアルに近いもの，
一般的にはもっと詳細なものを最初に作るはずだと思う。
更に言えば，殆どの奴らは既存システムの改善（保守）をやっているので，既存の操作の変更があれば，最初に
どことどこを変更って決めたものを書いておかないとユーザ（またはマニュアル部隊）が困るはず。
ユーザに渡す前なら作った後でも良いし，正直最後に微修正が入ることもあるとは思う。
昔ユーザに「ソース読めば？」って言ったプログラマが居たが喧嘩になったよ。もうアホかと…
・詳細設計書
将来の誰かに対して残しておくってこともあるだろうけど，どこをどう直したかを書類としてのこしておかないと
ビルダー（パッケージング）する奴が困ると思うぞ。ちゃんとしたSEなら，どこを直したのか把握して全体の
調整もするはずだ。馬鹿SEも多いが，そういう書類を作って公開しておけば隣近所の奴が何やっているのかも
分かるしね。ソースから読めって奴もいるだろうけど，STABLE な状態ばっかりで開発できる羨ましい環境で
生活してんだなと思うぞ。
んじゃ。
- 91 名前：デフォルトの名無しさん mailto:sage [03/10/25 16:59]
- >>90
すんごいローカル定義だこと。
- 92 名前：(゜Jし゜） mailto:sage [03/10/26 11:50]
- ちなみにそのプロジェクト、外部仕様書は件の暇人を使って
書かせていたのでユーザには迷惑は掛かりませんでしたが…。
そしてそのPMは寄寓にもジャスト35歳だったりして。
結局、自分で書きましたよ、ええ。
後でメンテする人が困るし。
- 93 名前：デフォルトの名無しさん mailto:sage [03/10/26 12:20]
- >>92
きみが書いた仕様書は、誰も解読できないと思うけどね・・・
- 94 名前：(゜Jし゜） mailto:sage [03/10/26 23:59]
- >>93
痛いところを突きますね。
確かに自分の書いた仕様書は自分用のメモみたいな程度のもんでした。
でもまぁ無いよりはましかな、とか思ったもので…。
まーその辺の現実に目を背けたくてこんなスレにいるわけですが。
- 95 名前：デフォルトの名無しさん [03/10/27 13:04]
- 自分はＳＥではなくプログラマーなのですが
プログラマーとしてドキュメントはどんなものを書いていますか？
ウチは外注のソフトハウスで
ＰＭ・ＳＥは元請け会社がやっています。
元請け会社が作った、基本仕様書（仕様書とは名ばかりで、機能が羅列して書いてあるだけ）
を元にプログラムを書くのが
我々の仕事なのですが、
元請け会社に提出用のドキュメントや、
社内の人間に、自分が休んだり辞めたりした後に
他の人でも対応して貰えるように残しておくドキュメントとして
どんなものを作って（書いて）いますか。
ちなみに、今、私は一太郎でドキュメントをシコタマ書いていますが
ドキュメントを書く便利なツールやソフトって無いですか？
- 96 名前：デフォルトの名無しさん mailto:sage [03/10/27 13:18]
- DBから吸い出せば一発で分かるテーブルレイアウト図なんかいりません。
ER図(これもツールで吸いだせるケース多し)と、DFDだけは残してください。
全文検索に引っかかりにくく死蔵になりやすいOffice文書も正直ｲﾔです。
- 97 名前：95 [03/10/27 13:21]
- ちなみにウチの会社
ドキュメントの作成が、みんなマチマチで
ロクなドキュメントを残さないので、
「作った本人しかわかりません、触れません」状態になっており
休みの日にドラブルが起きると
家や携帯に電話が入る。
おちおち、休んでもいられない
杜撰な会社です
- 98 名前：デフォルトの名無しさん mailto:sage [03/10/28 03:47]
- そういや、いくらがんばってドキュメント書いても、誰も読まずに聞いてくる。
- 99 名前：デフォルトの名無しさん mailto:sage [03/10/28 09:49]
- >>98
それはロクなドキュメントじゃないから。
- 100 名前：デフォルトの名無しさん mailto:sage [03/10/28 09:51]
- >>96
テーブルレイアウト図（って何だ？）を見たいと思った人間が、いちいちDBから吸いださずに
すむという理由で、テーブルレイアウト図（って何だ？）は存在しておいたほうがよい。
- 101 名前：デフォルトの名無しさん mailto:sage [03/10/28 09:52]
- >>96
Office文書がいやなら当然PDFもいやなんだろうが、だとするといったい何で書けと？
- 102 名前：デフォルトの名無しさん mailto:sage [03/10/28 10:49]
- >100
DBのテーブル毎にカラム名やキー、制約なんかを記述したドキュメントの事だけど。
テーブルレイアウトって言わない？これってローカル語なのか…ｽﾏｿ一般的には何て言うの?
DBからの吸出しは事実上ワンクリックで済む以上、手間では無いと思っているのだが・・・
>96
プレーンテキスト。あとはWikiかな。
もちろん、テキストだけで表現できない要素ならそれにはこだわりません。
OfficeやPDFだとどうしても見栄え的な部分へ力を割かなきゃいかんし更新の際に差分を
残しにくいのものも嫌いな理由の一つ。
あくまでも、内部用ドキュメントの話ね。外部に出すならワープロで作るのは構わないと思う。
- 103 名前：デフォルトの名無しさん mailto:sage [03/10/28 11:31]
- どうせおまいら"理科系の作文技術"すら読んでないんだろ？
- 104 名前：デフォルトの名無しさん mailto:sage [03/10/28 18:17]
- >>99
読んでないのにろくなドキュメントかどうか分かるわけないだろう
- 105 名前：デフォルトの名無しさん mailto:sage [03/10/28 18:50]
- 読まれないということはロクなドキュメントじゃないからだって事でわ?
- 106 名前：デフォルトの名無しさん mailto:sage [03/10/28 19:34]
- >>105
>>104
- 107 名前：デフォルトの名無しさん mailto:sage [03/10/28 21:41]
- まーふぃーの法則。
誰も読まないからドキュメントを書かないでいると、必ずドキュメントを要求される。
- 108 名前：デフォルトの名無しさん mailto:sage [03/10/28 21:49]
- 補足：
書くと今度は誰も読まない。
- 109 名前：デフォルトの名無しさん mailto:sage [03/10/28 22:16]
- >>102
> >100
> DBのテーブル毎にカラム名やキー、制約なんかを記述したドキュメントの事だけど。
> テーブルレイアウトって言わない？これってローカル語なのか…ｽﾏｿ一般的には何て言うの?
> DBからの吸出しは事実上ワンクリックで済む以上、手間では無いと思っているのだが・・・
ファイルとして保存しておけば、1秒もかからずに誰でも見始めることができるのだが。
> >96
> プレーンテキスト。あとはWikiかな。
> もちろん、テキストだけで表現できない要素ならそれにはこだわりません。
> OfficeやPDFだとどうしても見栄え的な部分へ力を割かなきゃいかんし更新の際に差分を
> 残しにくいのものも嫌いな理由の一つ。
> あくまでも、内部用ドキュメントの話ね。外部に出すならワープロで作るのは構わないと思う。
たぶんOfficeの使い方を間違っている。というか使いこなしていない。
Wikiで書いた文章を配布するときはどうするんだ？HTMLで配布するのか？
- 110 名前：デフォルトの名無しさん mailto:sage [03/10/29 09:04]
- >109
そのファイルが現物のDBを反映した物である保証があるならそれもアリですな。
>96
Officeに文書のバージョン管理の機能ってあるの?
是非教えてくれ。Officeを好きになれるかも。
配布に関しては別の話になると思うのだが・・・
まぁHTMLに吐くのもアリだしWikiによってはそのままPDF吐いてくれる物もあるし。
んで「テーブルレイアウト図」は一般的なんでしょうか。
気になって夜も眠れません・・・
- 111 名前：デフォルトの名無しさん mailto:sage [03/10/29 10:43]
- >>110
ぐぐってみりゃわかるだろうが。
日本語のページからテーブルレイアウト図を検索しました。 約6件中1 - 4件目 ・検索にかかった時間0.21秒
普通は「テーブルレイアウト」という。
- 112 名前：デフォルトの名無しさん [03/10/29 21:57]
- >>110
>Officeに文書のバージョン管理の機能ってあるの?
少なくともWordにはある。
が、ファイルがどんどん肥大化するのでお薦めできない
- 113 名前：デフォルトの名無しさん [03/10/29 22:01]
- Wordでどうやんの？
- 114 名前：デフォルトの名無しさん [03/10/30 00:25]
- 制御系のプログラマの場合、
開発した後、どんなドキュメントを残しますか？
- 115 名前：デフォルトの名無しさん mailto:sage [03/10/30 00:28]
- >>110
カラムの名称や型や制約に関する記述はスキーマとかテーブル定義書って言うんじゃ
なかったっけ。テーブル間の関連を図示したものはＥＲＤだな。
- 116 名前：110 mailto:sage [03/10/30 08:45]
- >111
あ、そういう事か。
図を抜く訳ね。
てっきり「一般的にはみかんと呼ばれる物を俺のところではりんごと呼んでいた」
くらい違うのかと思ってた。
今後気をつける。
- 117 名前：デフォルトの名無しさん [03/10/30 10:00]
- >>114
当然相手に応じて。
言われなければ俺は
回路図とかの図面はPDFにして
テキストで書ける事は全部ソースに全部埋め込む。
- 118 名前：112 [03/10/30 22:22]
- >>113
どうやんのって、持ってるならヘルプ見れよ！！！
今回だけだぞ、
[ファイル]−[版の管理...]
- 119 名前：デフォルトの名無しさん mailto:sage [03/10/31 01:07]
- ドキュメントのメンテ工数もらえないうちらはどうすればよいでしょうか
- 120 名前：デフォルトの名無しさん mailto:sage [03/10/31 12:07]
- その分別工程に上乗せ。
- 121 名前：デフォルトの名無しさん [03/11/21 23:23]
- Doxygen Release 1.3.5 age
- 122 名前：デフォルトの名無しさん mailto:sage [03/11/22 13:45]
- DoxygenでXHTMLを吐く上手い方法はないかね？
- 123 名前：デフォルトの名無しさん mailto:sage [03/11/22 17:58]
- Doxygenの出力パーサを弄くるとか。
あれってC++だっけ？
Doxygenレベルのlexerが単体で使えれば楽になることが沢山あるんだが・・。
- 124 名前：デフォルトの名無しさん [04/02/17 16:19]
- 仕様書ってーか、目論見書つくらんといけなかったのですが、
windowsのアプリ完成後のイメージを作成するのに、
簡単にコントロールぺタぺタできるのありませんかね？
ＶＣのダイアログボックスも、ＶＢのダイアログボックスもめんどくさいとこあるし・・・。
どなたか良いのありましたら教えてください。
- 125 名前：デフォルトの名無しさん mailto:sage [04/02/18 00:59]
- 目論見書って、金融の目論見書しか知らないんだけど。
その目論見書？
それにWindows の UI を乗せる必要がある？
- 126 名前：デフォルトの名無しさん [04/02/18 09:21]
- >>125
レスありがとうございます。
なんつーんでしょうかね？まぁ、こんなん作りますがみたいなのを他社に送るもんらしいです。
まぁ、中身も当然ですがＵＩの使いかってがかなり重要っぽいので・・・。
もう、フリーハンドでもいいとおもうんですけどね・・・。
とりあえず、今回はまぁそれなりに書いたんでどね。
次回以降ワードあたりでしこしこ線引くのも疲れるんで、なんか楽なの無いかな？と思いまして・・・。
- 127 名前：デフォルトの名無しさん mailto:sage [04/02/18 20:18]
- Visioなら書けるが、VC・VBの方が楽。よってVisioでは無理。
- 128 名前：デフォルトの名無しさん [04/02/18 21:45]
- >>127
wxWindowsのGUIツールキットBOAとかFOXとかFLTKあたりで作成できないもんかと思って、
とりあえず、暇できたらなんか色々チャレンジしてみます。
でも、.NET対応流行ったらどうすっぺ・・・。
- 129 名前：デフォルトの名無しさん mailto:sage [04/02/18 22:36]
- FLTKは日本語まわりがアレ、wxWindowはちょっとDLLがデカイ
gtk+ 導入するのにものすごい壁がある。 Foxは知らん。
なんとなく実用的なものならwxWindowがいい、
でもどれでもポトペタは無理だと思う。
- 130 名前：デフォルトの名無しさん mailto:sage [04/02/18 22:44]
- ポトペタってなに？
- 131 名前：デフォルトの名無しさん mailto:sage [04/02/18 23:15]
- >>126
俺の会社の先輩はPowerPoint使ってデモしてました。
文字入力画面はできない(アニメーションでやってた)みたいだけど、
ボタンと画面表示はリンクで適当に作ってました。
全画面表示のアプリで、それっぽく見せてましたよ。
- 132 名前：デフォルトの名無しさん mailto:sage [04/02/18 23:42]
- まぁVBが一番楽なんだろうね。
- 133 名前：デフォルトの名無しさん mailto:sage [04/02/19 01:56]
- 画面設計書じゃないから、それこそ"○○部分"と書いた枠の配置だけでいいと思う。
というか、そうでもして抽象化しないと完成画面だと思われる。
はっきりいえば、Windows の画面かどうかも分からないように書いたほうがいい。
- 134 名前：デフォルトの名無しさん mailto:sage [04/02/19 06:20]
- もしもしTcl/Tkを忘れてますよ
- 135 名前：124 mailto:sage [04/02/19 09:35]
- >>129-134
みなさまどーもありとうございます。
>>129,132
ポトペタ（ポトッとおとしてペたって貼り付け？）は無理ですか。
ＶＢで適当につくるのがいいんですかね・・・。
でもおいらＶＢ苦手っす（なんかめんどいからかな？）。
超初心者用ページでいいページないですかね（スレ違い）。
C++ならそれなりにモウマンタイって感じなんですけど。
>>131
パワーポイントっすか。使ったことないですね。考慮してみます。
>>133
うーむ、画面設計書とかそこらへんの違いよくわからないです。
そういうのわかる書籍とかページありませんか？（スレ違い？）
とりあえず、今度は抽象化してだしてみますね。
>>134
あ、どもです。とあるページに載ってなかったもんでメジャーではないのかと思いまして。
（ここのＧＵＩスレには載ってますけど）
- 136 名前：デフォルトの名無しさん mailto:sage [04/02/26 23:15]
- 末端プログラマしかやったことないんですが、
ちょっとＰＭで設計書の類（まだはっきりしてないけど）を書く必要にせまられました。
で、役立つオススメな本あります？
- 137 名前：デフォルトの名無しさん mailto:sage [04/02/27 22:42]
- まず、身の周りに先輩達が書いた設計書(見本)がないか探してみる。
なかったり、どうしようもないような代物なら…ガンガレ。
プログラム 設計書 で ぐぐると合うような物が見つかるかもよ。
- 138 名前：デフォルトの名無しさん mailto:sage [04/02/27 22:47]
- 周りに先輩達が書いた設計書(見本)がないか探してみる。
なかったり、どうしようもない代物だったら…ガンガレ。
プログラム 設計書 でぐぐる
要求定義からやる羽目になる罠もあるのでその辺もひっかけておく。
- 139 名前：デフォルトの名無しさん mailto:sage [04/02/27 22:50]
- 二重カキコ。逝って(ry
＿|￣|○
- 140 名前：(゜Jし゜） mailto:sage [04/02/27 23:55]
- www.seshop.com/detail.asp?pid=4448
このへんどうよ？
- 141 名前：136 mailto:sage [04/02/28 05:24]
- >>137-139
ありがとうございます。あさってみます。
>>140
ありがとうございます。アキバのラオックスで立ち読みして、よさそうならかってきます。
- 142 名前：http://bulkfeeds.net/app/search2?q=UML [04/03/31 00:03]
- UML・仕様書・設計書関連2chスレッドのまとめ （siyousyo - wikich）
pwiki.chbox.com/pukiwiki.php?siyousyo
bulkfeeds.net/app/search2?q=UML
- 143 名前：デフォルトの名無しさん [04/05/11 00:16]
- doxygen 1.3.7 age
- 144 名前：デフォルトの名無しさん [04/07/18 17:51]
- 詳細設計書は、プログラム処理の羅列でいいんだよね？
- 145 名前：デフォルトの名無しさん mailto:sage [04/07/20 02:43]
- >プログラム処理の羅列
ダメ、それはプログラム設計書だNe!
- 146 名前：デフォルトの名無しさん [04/07/25 19:54]
- doxygen 1.3.8 age
- 147 名前：デフォルトの名無しさん mailto:sage [04/09/11 00:13:39]
- 142さんありがとうございます。助かりました。
激遅レスだけど、感謝です。
- 148 名前：あげ [04/09/25 05:02:40]
- doxygenで複数の言語向けのドキュメントを書くにはどうすればよいのだろう？
- 149 名前：デフォルトの名無しさん [04/09/25 05:06:02]
- www.npb.or.jp/
- 150 名前：148 mailto:sage [04/09/25 05:09:09]
- すまん。
doxygen+"two languages"でぐぐったらマニュアルの\ifディレクティブの項に書いてある事が分かった。
- 151 名前：デフォルトの名無しさん mailto:sage [04/09/28 16:09:35]
- 保守
|
 |
