トップページ⇒tech
649コメント214KB

良いドキュメント・マニュアル・仕様書を書くスレ

■ このスレッドは過去ログ倉庫に格納されています
0001デフォルトの名無しさんNGNG
おまえら、自分で作ったプログラムについての、わかりやすく的確な
ドキュメントを書ける自信はあるか?
仕事で納品したり、他人に見せるプログラムとして公開するつもりなら、
マニュアルや、仕様書などのドキュメントを書く機会は必ずある。

プログラムとドキュメントはとても関係が深い。ドキュメントが整っていない
プログラムなど、ゴミと同じ。それに、ただ書けばいいって物でもない。
ドキュメントがゴミ程の役にも立たなければ、結局それはゴミなのだ。
だらだらと書いた意味不明な文章を他人に見られるのも恥ずかしいよな?

いわばドキュメントを書く技術はプログラマの必須スキルの1つなのだが、
実際は、下手糞なドキュメントが蔓延っている。(これはGNU製に多い)
読んでも無駄とか、書いても無駄とか思ってる奴、その考えを改めろ。
プログラムに対するドキュメントを、ちゃんとした1作品として、
後世に残せるよう努力すべきだろう。

今一度問う。
おまえら、わかりやすく的確なドキュメントを書ける自信はあるか?
0232デフォルトの名無しさん2005/06/13(月) 01:22:28
みなさんいろいろ言ってますが
それでお客に納品するの?
おいらは、Visioやパワーポイントも使わないようにしてるけど
打ち合わせ資料で使うときあるけど、最終的にはエクセルで書き直す事になる
02332232005/06/13(月) 01:31:32
>>231
ふむ、試してみます
0234デフォルトの名無しさん2005/06/13(月) 03:52:03
XMLにコードとドキュメントを共存できる
XMLに対応したコンパイラ
0235デフォルトの名無しさん2005/06/13(月) 11:35:27
>>234
XMLってマジで言ってますか?
0236デフォルトの名無しさん2005/06/13(月) 20:30:41
>>234
XSLT使えばどうにでもなる気がする
0237デフォルトの名無しさん2005/06/14(火) 13:26:23
つーかかつて Knuth というシトが
「文芸的プログラミング」(literary programming)
つーのを提唱して WEB つーシステムを開発したよね
それやりゃいいんだろ
0238デフォルトの名無しさん2005/06/14(火) 21:01:39
               ,,r'"          `ヽ,、
           ,r"  .,/i、      .ヘ,  `ヽ、
          、"   ./::::::i,   /ヽ  l..:::i,  . '、
          /   .,/:::::::::::i  /.,:::l i::::::::i 、  ヽ
         / .,、.,i:::::::::::::::i, /:::::::::v,,:::::::::l, ,li   i
         │ /:l./::::i::::|l::::::V,:::::::/i:::::::ヘ::::::V::l, . |  ,.,..,,.,..、、
            | ./:::l:::::::l-i:|-!::::::::::::::/ 'l:::/--l::::::;;;;l ..レ'"´
            l .i::::::::::::l-i-'。.ヽ::::::::/ ´l/-。、i:::::::::::! ..i   可 理
         '!l:::::::: ヘl |::::::l` i:::::/  イ::::::| ,!/::::::. i |  能 論
            i::::/i::::l,`  ̄`  V     ̄   i::::i::::./   な 上
             V l::::l,           J /::::i "i/   ん は
               ゙l:::\    __     ./l:::/      で
            '!/  ヽ._ ヽ   ノ ,/" iv         す
               _.|`ヽ- -イ|_ <        ゚
             ,,、ノ;;;;;;;|||||  |||||;;;;;;;ヽ.`!

SmartDocみたいな使えないものになるのが落ち
0239デフォルトの名無しさん2005/06/26(日) 01:01:12
今のプロジェクトのドキュメントは
基本設計書からすべてExcelだ(´・ω・`)
確かに図を書くのがラクだけど・・・
0240デフォルトの名無しさん2005/06/26(日) 17:00:24
質のいいスケルトンがあれば
Wordでもなんでもいいと思う
0241デフォルトの名無しさん2005/06/26(日) 17:48:03
>>240
おれ、ワードは線がずれたら直せないんだよ。
0242デフォルトの名無しさん2005/06/26(日) 17:52:50
>>241
根性、根性、ど根性

ちなみにIMEだと ど根性 で一単語になってる
0243デフォルトの名無しさん2005/06/27(月) 03:53:01
IME
0244デフォルトの名無しさん2005/06/27(月) 12:39:17
MS-IMEもATOKも「IME」だからな
0245デフォルトの名無しさん2005/06/28(火) 11:06:46
MS-IMEがポピュラーになるまでは
FEPって方が通りがよかった。
だからついMS-IMEの事をIMEといってしまうま。
0246デフォルトの名無しさん2005/08/21(日) 20:15:27
そんなことないよ
0247デフォルトの名無しさん2005/08/22(月) 09:31:21
結局、仕様書書くのにどんなアプリつかっている?

俺の場合
図や表、文をまぜこみの仕様書である程度見栄えも気にする場合は、
OpenOfficeOrg2.0Betaを使っている。
Wordは俺は受け付けることができなかったが、Oooはなんとか好きになれそう。


htmlでやっているって言う人は、テキストエディタでごりごり書いているのだろうか?
ま、それが一番書きやすいのだが、そろそろhtmlエディタで良いのが出てきてほしいなあ。
0248デフォルトの名無しさん2005/08/22(月) 19:05:24
マクロ使えるエクセルに決まってんじゃん
Wordは俺のUIと合わなかった
0249デフォルトの名無しさん2005/08/27(土) 15:18:42
Wordは、いらぬお世話をするオプション類を全部OFFにして使えば使える。
挙動不審な事が多いし良く落ちるがドキュメントやマニュアルを書くのにはやっぱ
エクセルよりワードだな。
0250デフォルトの名無しさん2005/09/03(土) 13:55:02
一度、どこかマ板辺りで
プログラマのためのワード講座
みたいなスレを立ててみようか

使いにくいと文句をいっている人は
例えるなら秀丸でVC++のソース編集してるようなもので
きちんと環境構築と突然死への備えを整えれば
VisualStudioなみの便利さを手に入れることはできる
0251デフォルトの名無しさん2005/09/10(土) 01:05:56
僕は、LaTeXちゃん!
0252デフォルトの名無しさん2005/09/10(土) 04:56:03
うちは何故かエクセル。開発環境はLinux+Eclipseなのに、文章作成は
Windowsでエクセル( ゚д゚)ポカーン
社内通達がエクセルで回って来た事もある。本文無しで添付ファイル
があるだけという、思わずゴミ箱に放りそうになったぞ。

それはそれとして、前に文章作成なのに何故エクセル?という問いを
投げてみたんだが、エクセルで何の問題がある?と聞き返されて有耶
無耶になった。
ワードを使えば云々と言えるほど、俺はオフィスツール知らんからな。
て言うか、正直エクセルも線の引き方と文字の属性変更くらいしか知
らんのだけどねorz

誰もが納得するワードの利点とかあるなら聞きたい>250
0253デフォルトの名無しさん2005/09/10(土) 08:15:48
>>252
おぢさん達はExcelが大好きなのです。
日々の報告書からプレゼン資料まで、全部Excelで作ってくれます。
Wordは勝手に整形しやがるから使いにくいそうです。
罫線使いまくりの日本語文書はExcelの方が使いやすいんでしょう。

250じゃないが、誰もが納得するWordの利点: (取引先も含めて)みんなが使ってる
0254デフォルトの名無しさん2005/09/10(土) 09:31:46
目次勝手につくってくれる

分厚い仕様書を方眼紙みたくしたエクセルで書かされて
目次の管理で死にました。
0255デフォルトの名無しさん2005/09/10(土) 15:11:30
>>252
スタイル

なぜかあんまり使われていないようですが……
0256名無しさん@そうだ選挙に行こう2005/09/10(土) 19:01:51
>>252
エクセルだと表計算と図と文章作成、全てエクセル
でやろうと思えば済んでしまうらしいので、プレゼン資料
とかも全部エクセルだけにしてる奴がたまにいるw
0257名無しさん@そうだ選挙に行こう2005/09/10(土) 20:13:54
>>253
みんなが使ってる度ならExcelの方が上じゃない?
少なくともWordの方が一方的に有利って事はないと思う。

>>255
初めて聞いたw

>>256
最近、MindManager(MindMap)が大人気。
少し前はEA(UseCase)が大流行だったが
次は何が流行るんだろう?
0258名無しさん@そうだ選挙に行こう2005/09/11(日) 00:56:45
>>257
Wordのスタイル、少し覚えてみなよ。
マジデ便利だから。
0259名無しさん@そうだ選挙に行こう2005/09/11(日) 01:08:00
なんか興味が出てきてWordを立ち上げてみる
インストールして5年は経っているが、たぶんこれが起動2回目くらいだな

んでしばらくイジくってみたんだけど、テキストボックス使えればOKな感じでいいのかね?
他にめぼしい機能あるかな。些末なの抜きで。
0260名無しさん@そうだ選挙に行こう2005/09/11(日) 03:38:57
>>259
>些末なの抜きで。

Wordの売りはむしろ些末な機能が豊富にあるとこかもしれんwww
0261名無しさん@そうだ選挙に行こう2005/09/11(日) 03:40:38
デフォ設定で自動補正になってなけりゃもっと評価高いかも
迷惑な便利機能を殺したくてその便利機能について学ぶという不毛な時間がすごくアレだ
0262名無しさん@そうだ選挙に行こう2005/09/11(日) 04:01:28
でも、ホント、Word の売りってなんなんだろうな?

パワポは俺も最近までは全然評価してなかったんだけど、会議で使う資料をパワポで作ったら、
いつもテキストファイルで書いてる内容と変わらんのに、妙に内容の評価がよくてワラタ。
やっぱり人は体裁で騙されるもんだなwww  ・・・それからはパワポに一目置いている俺ガイル。
0263名無しさん@そうだ選挙に行こう2005/09/11(日) 11:27:31
>>262
発表において、体裁ってもんがどれほど重要か。
どんな小手先の技でもいいから、人の気を引くというのは大切よ。

Word の利点、ぱっと思いついたのだと、
- 修正履歴を残せる → 学生の論文チェックとかかなり楽
- コメントを付けれる → これも校正に凄く便利
- スペルチェック → 英文はとりあえず最初 Word で書いとけみたいな
- 一応、段落ごとにスタイル定義しておいて、スタイルの書式変更したら同じスタイル一斉に変更される
0264名無しさん@そうだ選挙に行こう2005/09/11(日) 13:27:47
Wordで20ページ↑の仕様書を書いてみればわかるよ
スタイルとかクロスリファレンスつけておくとマジ便利
目次や索引も自動で作れるし。
これでもう少し図形描画の機能が充実してればなぁ・・・
ま、そっちはVisio使ってるからいいんだけど。

#でも、個人的にはLaTexを吐いてくれるエディタが欲しいところ
0265名無しさん@そうだ選挙に行こう2005/09/11(日) 13:29:26
利点
- 目次作成 + 自動更新
- 図表番号の自動更新
0266名無しさん@そうだ選挙に行こう2005/09/11(日) 17:20:24
>>263-265

どれも俺からすると些末な機能なんだけど。

XSLTが大好きな俺的にはXML形式に対応してるところなんかが蝶最高なんだけど、
これはExcelやパワポでもできることだしな。
0267名無しさん@そうだ選挙に行こう2005/09/11(日) 17:33:54
Wordの最大のウリは
多数派であるということ
0268名無しさん@そうだ選挙に行こう2005/09/11(日) 17:50:31
>>264
最近のはマシなんか?
Wordでページ数多い文書作ると重いわすぐ落ちるわで……
いい印象無かったんだが
0269名無しさん@そうだ選挙に行こう2005/09/11(日) 18:28:11
>>264-265
この辺のテンプレート集とかスクリプト集ってある?
折角の利点も簡便で分かり易くないと説得が難しい。
偉いさんてのはプライドを刺激されると意固地になるからな。彼らは難しいとか
理解できないを決して口にせず、それらを必要がないの一言で片付けてしまう。
0270名無しさん@そうだ選挙に行こう2005/09/11(日) 18:32:51
>>267
Excelの方が多数派だよ?
総務などの非生産部門には必ずと言っていいほどExcelが導入されてるから
0271名無しさん@そうだ選挙に行こう2005/09/11(日) 18:33:14
>>269
目次だのなんだのって、単なるWordの基本機能だから、スクリプトは不要だよ。
ちゃんとスタイル使って(「見出し1」とか「見出し2」とか)文書を
書けば、章番号を自動で振ってくれるし、後でそれをもとに自動で目次が作れる。
0272名無しさん@そうだ選挙に行こう2005/09/11(日) 18:34:18
>>270
ExcelとWordでは用途が違うというだけの話だ。
適材適所で使い分けるのが賢いやり方。
0273名無しさん@そうだ選挙に行こう2005/09/11(日) 18:51:04
>>271
ありゃ?そうなのか、て言うか基本機能なのかよ!
俺自身が実際に触って、基本機能くらいは理解しないと話にもならんな_| ̄|○|||
それが何とも億劫と言えば億劫なんだが……
俺も偉いさんの事をとやかくは言えんな……

>>272
問題は、決して賢くないという点だ!Σ(´Д` )
0274名無しさん@そうだ選挙に行こう2005/09/11(日) 19:02:01
>>273
http://www.amazon.co.jp/exec/obidos/ASIN/4774117501/
この本がおすすめ。

アウトラインモードで取り敢えず書くのが
自然に思えてきたら結構使ってる人なんじゃないでしょか。
0275名無しさん@そうだ選挙に行こう2005/09/11(日) 21:47:06
>>273
俺、元々LaTeX派だったけど、3日でWordに転向しちゃったよ。
割とすぐ覚えれる。
0276名無しさん@そうだ選挙に行こう2005/09/11(日) 21:50:52
>>274

この本、自分も人から薦められて買ったけど、かなりいい本ですね。
職場に一冊常備すべし。
0277名無しさん@そうだ選挙に行こう2005/09/11(日) 22:54:18
Win板かソフ板の話題が続いている件について
0278デフォルトの名無しさん2005/09/12(月) 00:35:07
>>274-276
ホントかよ?ジエリじゃねぇだろうなw
とりあえず明日本屋行ってくるよ。初心者向けではないみたいだから
一緒に入門書も買ってくる。
0279デフォルトの名無しさん2005/09/12(月) 00:59:59
>>278
じえんじゃないよ。
まあじえんだとしてもいいじゃん
本屋で立ち読みしてみて決めてちょー。

カラーページがないところとかが硬派で
それだけで好感が持てますだ。

DTPのマナーみたいな話も、システム文書には
必要ないけど、面白かったな。
0280デフォルトの名無しさん2005/09/16(金) 00:55:41
Wordのスタイル機能は書式をいぢりづらいのがネック。
特にスタイル使わずに書かれた文章にスタイルを導入しようとすると死ねる。
0281デフォルトの名無しさん2005/09/16(金) 10:45:36
>>280
あとからは相当骨でしょそりゃー。
0282デフォルトの名無しさん2005/09/23(金) 00:26:28
なんかMSワードって何処でも決まって悪者にされる傾向があるけどなんでだろうね。
俺はかなり良いソフトだと思うんだけど。いやマジで。

今までアドビのフレームメーカーとかロータスのワードプロも触ってきてるけど
ワードのUIはそれらより飛びぬけて直観的だし、機能も多い。

ワード使い難いって奴はフレームメーカー使ってみるといいかも。
フレームメーカーの糞UIはマジで殺したくなるよ。それでいてワードより高かったりしたから恐れ入る。

まあでも時々挙動不審だったりするし、段落番号の設定みたいに異常にわかり難い
UIがあったりする欠点は確かにあるな。

それにしても、ワード貶してる奴らに関しては、ワードの問題というより
そいつらの能力の問題じゃないかと思うが。
0283デフォルトの名無しさん2005/09/23(金) 01:07:59
デフォルト設定のせい
UNIXが使いにくいのとおなじ
0284デフォルトの名無しさん2005/09/23(金) 11:01:41
それにしても、UNIX貶してる奴らに関しては、UNIXの問題というより
そいつらの能力の問題じゃないかと思うが。
0285デフォルトの名無しさん2005/09/23(金) 14:04:57
じゃあWordに文句を言うやつも無能だな。
0286デフォルトの名無しさん2005/10/10(月) 16:31:55
>>285
そりゃ無能だろ
0287デフォルトの名無しさん2005/10/10(月) 17:27:01
あーでもWordの使いにくさとUNIXの使いにくさは別だな。
UNIXはどうしようもないからな。
0288デフォルトの名無しさん2005/10/10(月) 17:33:25
doxygen 1.4.5 age
0289デフォルトの名無しさん2005/10/10(月) 17:34:07
なんで並列に語ってるのか知らないけど あえてノルなら
Wordの使いにくさは 袋小路 であり、UNIXの使いにくさは 迷路 だ。

Wordでやりたいことをやるとき、正式な方法が無いことはよくあり
正式じゃない方法で突破することが多い
UNIXでやりたいことをやるとき、正式な方法がそもそも難解で
そのことを訴えると「道があるんだからいいだろ」と突っぱねる
0290デフォルトの名無しさん2005/10/10(月) 18:29:51
Linuxの場合、とっつきやすさや使いやすさを最初から目指していないのだから使いにくくて当然な気がする。
Wordはなー。MSってUIにけっこう力入れてるはずなのになんであんなことになるのか。
0291デフォルトの名無しさん2005/10/10(月) 19:38:35
英文だと一般の評判多少マシなのか?
0292デフォルトの名無しさん2005/10/11(火) 11:07:21
ドキュメンテーションを書くときは常に例を書き込むとかなりグー。
PHPのドキュメンテーションなんていい例じゃないかな。
使い方系のドキュメンテーションはシナリオ書いとく。

ところで、結局Wiki立てても書くのは結局一人だけだよなぁ。
でもみんなで書くという機能よりも手軽にどこからでも書けるというのが気に入ってる。
使いこなすとかなり快適。あとはVISIOでちょっと図を描いて終了。
0293デフォルトの名無しさん2005/10/27(木) 03:40:16
確かにリファレンスとかは、
動作例ある方が読みやすいもんな。

つーか動作例無いと、リファレンスに見えないというか。
0294デフォルトの名無しさん2005/11/01(火) 01:47:40
ドキュメントなんか書いてる暇があったらソースを書け。
0295デフォルトの名無しさん2005/11/06(日) 15:48:48
概要仕様はワープロソフトできっちり作るな。納品しやすいし。
細かい仕様はソースにコメント埋めまくり。

ワードとかUNIX使いこなせない香具師はスキル低いだけ。

何か一つだけしか覚えられない香具師がエクセル使っている感が有るな。
自由紙、原稿用紙、レポート用紙、方眼用紙っていろいろあるけど、どれか一つ選べって状態で方眼紙選んじゃってるだけだ。
レポート用紙にグラフも書けるのにさ。
0296デフォルトの名無しさん2005/11/11(金) 16:36:53
どのソフトを使うかなんか関係ないって。中身ですよ中身。
つーか、こんだけソフト開発が行われてるんだから、もちっとドキュメント作成技術も洗練されていてくると思うんだけどな〜。
どこのプロジェクト行っても、読まれない&読んでも意味ないドキュメントばっか。
新規で起こす時も役にたたねぇだろうなーと思いつつ作ってるし。

それともオレが知らないだけで、既に良いツールor作成理論とかあったりするの?
もしあったら教えてエロイひと
0297デフォルトの名無しさん2005/11/11(金) 22:53:22
>>296
コツを教えてあげるよ

自分が欲しいと思えるドキュメントを作ればいいよ
役に立つように作るべし
役に立たないと思った個所はどんどん削除
0298デフォルトの名無しさん2005/11/11(金) 22:55:25
あと、起承転結では読みづらいので 起結承転 を心がけること
0299デフォルトの名無しさん2005/11/11(金) 23:11:01
正直「転」はいらん。
0300デフォルトの名無しさん2005/11/11(金) 23:23:41
統合設計書作成アプリケーション作って。
普通のアプリでWikiっぽい機能+Wordの章番管理+Excelみたいな表が
自由に作れる幹事で
0301デフォルトの名無しさん2005/11/12(土) 08:19:16
転ってアレか。

この関数は○○の機能を持つ <- 起結
ただし、××の副作用を持つ <- 承転
0302デフォルトの名無しさん2005/11/12(土) 17:11:51
さすがにtxtを推奨する奴はいないようだ。
03032962005/11/14(月) 09:43:53
いや、ドキュメント書けないわけじゃないないけどね。
この業界、結局ウォーターフォール型がほとんどじゃない?
だったら 要求>仕様>設計>試験 ぐらいのテンプレートとか支援ツールあってもいいんじゃねーかなと思って。
それに有名な規格ができたら、顧客の理解度、満足度ももっと高くならないかなぁ。とか
(Rational Rose とかは勘弁な。”UML図”だけじゃレビュー通らないし)

あと変に思うのは設計書。実装イメージをそのまま文書にしたのをよく見かけるけど、設計書は利用者ガイドであるべきだと思うんだ。
あの高いソフト買うと付いてくる大量のマニュアル郡みたいに、コンセプト、概要、実装サンプル、注意点、とか。
設計者が変わりに文書で実装しても意味ないっしょ。

あ〜ぐだぐだと駄文書いてスマヌ
0304デフォルトの名無しさん2005/11/14(月) 10:41:15
俺もそう思う。
納品物としての仕様書なんかいらん。読んでくれないし。
きっちり書いたユーザーマニュアル納品すれば一番ブレがない。
要求は全てそこに落とせばいいんじゃないかなあと。
だからマニュアルといっても画面の説明だけじゃなくて
半分業務マニュアルって感じ。

所謂仕様書らしい仕様書は、
お客さんにガッチガチの情シスがあって
そこが出せっていうんだったら書くよ、って感じで
いいんじゃないでしょうか。

なんか仕様書とあまり変わらないか。
でも言葉とかフォーマットとか、もっとお客さんに優しい感じ。
0305デフォルトの名無しさん2005/11/14(月) 13:50:36
納品物としての仕様書は、
質重視ではなく量重視だな。
0306デフォルトの名無しさん2005/11/14(月) 15:40:39
すると普通の仕様書より表現が冗長になりそうな
マニュアルでの納品がやっぱいいな
スクリーンショットわんさかで
0307デフォルトの名無しさん2005/11/14(月) 21:10:06
>>301
そんな感じ
注意事項
0308デフォルトの名無しさん2005/11/15(火) 01:24:59
>>306
マニュアル + クラス仕様書(自動生成したもの) が最強。
そして両面印刷なんてもってのほか。
0309デフォルトの名無しさん2005/11/29(火) 03:00:58
>>254
亀レスすまそ。

よくExcelのセルを方眼紙みたい(正方形)にする人がいるんだけど、
あれって何が便利であんなセルにしちゃうわけ?
レイアウトしやすいってだけ?
0310デフォルトの名無しさん2005/11/29(火) 10:04:30
本当に方眼紙に仕様書を書いてた名残らしい。
あと、インデントしやすいからといってた。
03113092005/11/30(水) 18:12:53
>>310
方眼紙ってそのまんまかいなw
0312デフォルトの名無しさん2005/12/31(土) 19:33:11
doxygen 1.4.6 age
0313デフォルトの名無しさん2005/12/31(土) 20:00:13
wiki風の装飾付きtxtを書いて、自前ツール通してhtmlにしてるな。
リンクやレイアウトが簡単だし、ブラウザは誰でも入ってるから。
0314デフォルトの名無しさん2006/01/25(水) 17:59:27
doxygenのマニュアル読んでも、「使わねー」とか「ソース汚なくなるだけー」
みたいなコマンド(キーワードや記法)が多いと思ったんだけど、どう?
おまいらのdoxygenボキャブラリーはどんなもんよ?
0315デフォルトの名無しさん2006/01/25(水) 22:45:51
file brief author
pre post param return retval
後メンバグループにname { }
0316デフォルトの名無しさん2006/01/27(金) 09:26:58
>>315
それだけあれば、ひととおりの仕様は説明できそうだよね。
「意見」なんかを入れはじめるとややこしくなるんだよね。
0317デフォルトの名無しさん2006/02/25(土) 02:38:32
ドキュメントが書けないやつは自分の頭でわかってないからだ。
自分ではわかってるけど説明するのが下手というやつは、自分でも
わかってない。それは直感と連想能力とヒントでピントでプログラミング
してるだけだ。
0318デフォルトの名無しさん2006/02/25(土) 11:59:02
16分割の最初の2枚ぐらいでわかっちゃうようなやつには
ドキュメント作成なんてまだるっこしくってやってられんのだろうな。
馬鹿の気持ちが分からないから、標準からはずれたのを作成してしまう。

医者なんかでもそうだけど、臨床とかエンドユーザーが絡む作業は
あんまり頭が切れるヤツは向いてなくて、
ちょっと馬鹿だけどそれを自覚して慎重・着実に作業する
ヤツの方が向いてる。
0319デフォルトの名無しさん2006/03/04(土) 02:25:09
ソフトウェア開発の世界標準フォーマットみたいなもの無いかな
各工程で何の文書が必要で、どのような項目を記載するものだ、みたいな
0320デフォルトの名無しさん2006/03/32(土) 17:58:17
UMLって客に見せても実際は理解してもらえない。
客側に上級シスアドみたいなのがいれば話は別だが、現在ではそんな状況はあまりない。
結局UMLで書くってのは設計者のオナニーなんだなと思う。
なにしろUML試験なんかあるくらいだから、コンピュータど素人のお客にわかりやすいわけがない。

ところでXP開発におけるドキュメントの生成の仕方ってどうしてる?
うちは要件定義書が文章じゃなくて業務フローのの図だけなんだが。
そんなのが入力では詳細設計書なんて書けないぜ。
0321デフォルトの名無しさん2006/03/32(土) 18:31:53
UMLは客に理解してもらうためのもの、
なんて言ってる人はあなた以外に見たことありませんけどw

自分が勝手に銀の弾丸を求めてるだけでしょ?
銀の弾丸がきっとあるに違いないと無意識に思ってるから
ネジ廻しがネジを締めることにしか使えないことに苛立つんだよ。
0322デフォルトの名無しさん2006/03/32(土) 18:57:02
>UMLは客に理解してもらうためのもの、
>なんて言ってる人はあなた以外に見たことありませんけどw

見聞が狭いんだね。俺は何人か知ってるよ。
見たこともない、とは重傷だな。
0323デフォルトの名無しさん2006/03/32(土) 20:35:16
ダメなドキュメントってあるよね。当たり前のことしか書いてなくて、
ポイントが抑えられてないような。
UMLだろうがワードだろうが、同じ人間が書く限りダメなドキュメントなのは変わらないのが現実
0324デフォルトの名無しさん2006/03/32(土) 23:02:48
ドキュンメント
0325デフォルトの名無しさん2006/04/09(日) 00:06:13
みんなはdoxygenでコメント書くとき
Qtスタイルにしてます?JavaDocスタイルにしてます?
0326デフォルトの名無しさん2006/04/09(日) 17:17:32
JavaDoc スタイル。
Qt ってマイナーだし Qt にするメリットってあるの?
0327デフォルトの名無しさん2006/04/09(日) 20:37:45
>>320
むつかしく書きすぎ、細かく書きすぎ
なんじゃないの?
0328デフォルトの名無しさん2006/04/09(日) 21:42:04
言われてみればそうだよな…・。
伝えるだけなら、
紙に手書きしてコピったりスキャナで取り込むなりの方が遥かに敏速。
0329デフォルトの名無しさん2006/04/10(月) 03:00:04
>>319
それこそ本屋にいけば山ほどその手の本があるやん。
成果物が一番はっきり明示されているのはラショナル統一プロセス
じゃないの。ISO9001なんかを取得している会社なら社内標準で
成果物が設定されているでしょ。

>>320
オブジェクト指向言語で開発しているなら、それとの親和性の
高さという点から、内部設計はUMLでするのはいい。けど、
要求仕様をユースケースなんかで顧客に見せるやつの気が知れない。
というかそういうやついるのか?俺はずっと前からアンチユース
ケース派でそういうことばっかり言っているけど。
03303292006/04/10(月) 03:02:49
>>319
それと追記するけど、どんな職場や環境、メンバーのスキルに
合致した魔法の世界標準フォーマットは存在するわけがない。

それぞれに合致したものはそれぞれが苦労して考えるしかない。
参考にするのはいいけど、巷に出回っている開発プロセスを
そのままやろうとすると失敗するよ。
0331デフォルトの名無しさん2006/04/18(火) 15:12:14
質問。

仕様書だけ書いて、それを
ベクターみたいに、アップロードして
みんなに見せるサイトって、どこかある?
■ このスレッドは過去ログ倉庫に格納されています