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

良いドキュメント・マ ..

91:デフォルトの名無しさん
03/10/25 16:59
>>90
すんごいローカル定義だこと。

92:(゜Jし゜）
03/10/26 11:50
ちなみにそのプロジェクト、外部仕様書は件の暇人を使って
書かせていたのでユーザには迷惑は掛かりませんでしたが…。
そしてそのPMは寄寓にもジャスト35歳だったりして。

結局、自分で書きましたよ、ええ。
後でメンテする人が困るし。

93:デフォルトの名無しさん
03/10/26 12:20
>>92
きみが書いた仕様書は、誰も解読できないと思うけどね・・・

94:(゜Jし゜）
03/10/26 23:59
>>93
痛いところを突きますね。
確かに自分の書いた仕様書は自分用のメモみたいな程度のもんでした。
でもまぁ無いよりはましかな、とか思ったもので…。

まーその辺の現実に目を背けたくてこんなスレにいるわけですが。

95:デフォルトの名無しさん
03/10/27 13:04
自分はＳＥではなくプログラマーなのですが
プログラマーとしてドキュメントはどんなものを書いていますか？

ウチは外注のソフトハウスで
ＰＭ・ＳＥは元請け会社がやっています。
元請け会社が作った、基本仕様書（仕様書とは名ばかりで、機能が羅列して書いてあるだけ）
を元にプログラムを書くのが
我々の仕事なのですが、

元請け会社に提出用のドキュメントや、
社内の人間に、自分が休んだり辞めたりした後に
他の人でも対応して貰えるように残しておくドキュメントとして
どんなものを作って（書いて）いますか。

ちなみに、今、私は一太郎でドキュメントをシコタマ書いていますが
ドキュメントを書く便利なツールやソフトって無いですか？

96:デフォルトの名無しさん
03/10/27 13:18
DBから吸い出せば一発で分かるテーブルレイアウト図なんかいりません。
ER図(これもツールで吸いだせるケース多し)と、DFDだけは残してください。
全文検索に引っかかりにくく死蔵になりやすいOffice文書も正直ｲﾔです。

97:95
03/10/27 13:21
ちなみにウチの会社
ドキュメントの作成が、みんなマチマチで
ロクなドキュメントを残さないので、
「作った本人しかわかりません、触れません」状態になっており
休みの日にドラブルが起きると
家や携帯に電話が入る。

おちおち、休んでもいられない
杜撰な会社です

98:デフォルトの名無しさん
03/10/28 03:47
そういや、いくらがんばってドキュメント書いても、誰も読まずに聞いてくる。

99:デフォルトの名無しさん
03/10/28 09:49
>>98
それはロクなドキュメントじゃないから。

100:デフォルトの名無しさん
03/10/28 09:51
>>96
テーブルレイアウト図（って何だ？）を見たいと思った人間が、いちいちDBから吸いださずに
すむという理由で、テーブルレイアウト図（って何だ？）は存在しておいたほうがよい。

101:デフォルトの名無しさん
03/10/28 09:52
>>96
Office文書がいやなら当然PDFもいやなんだろうが、だとするといったい何で書けと？

102:デフォルトの名無しさん
03/10/28 10:49
>100
DBのテーブル毎にカラム名やキー、制約なんかを記述したドキュメントの事だけど。
テーブルレイアウトって言わない？これってローカル語なのか…ｽﾏｿ一般的には何て言うの?
DBからの吸出しは事実上ワンクリックで済む以上、手間では無いと思っているのだが・・・

>96
プレーンテキスト。あとはWikiかな。
もちろん、テキストだけで表現できない要素ならそれにはこだわりません。
OfficeやPDFだとどうしても見栄え的な部分へ力を割かなきゃいかんし更新の際に差分を
残しにくいのものも嫌いな理由の一つ。
あくまでも、内部用ドキュメントの話ね。外部に出すならワープロで作るのは構わないと思う。

103:デフォルトの名無しさん
03/10/28 11:31
どうせおまいら"理科系の作文技術"すら読んでないんだろ？

104:デフォルトの名無しさん
03/10/28 18:17
>>99
読んでないのにろくなドキュメントかどうか分かるわけないだろう

105:デフォルトの名無しさん
03/10/28 18:50
読まれないということはロクなドキュメントじゃないからだって事でわ?

106:デフォルトの名無しさん
03/10/28 19:34
>>105
>>104

107:デフォルトの名無しさん
03/10/28 21:41
まーふぃーの法則。
誰も読まないからドキュメントを書かないでいると、必ずドキュメントを要求される。

108:デフォルトの名無しさん
03/10/28 21:49
補足：
書くと今度は誰も読まない。

109:デフォルトの名無しさん
03/10/28 22:16
>>102
> >100
> DBのテーブル毎にカラム名やキー、制約なんかを記述したドキュメントの事だけど。
> テーブルレイアウトって言わない？これってローカル語なのか…ｽﾏｿ一般的には何て言うの?
> DBからの吸出しは事実上ワンクリックで済む以上、手間では無いと思っているのだが・・・

ファイルとして保存しておけば、1秒もかからずに誰でも見始めることができるのだが。

> >96
> プレーンテキスト。あとはWikiかな。
> もちろん、テキストだけで表現できない要素ならそれにはこだわりません。
> OfficeやPDFだとどうしても見栄え的な部分へ力を割かなきゃいかんし更新の際に差分を
> 残しにくいのものも嫌いな理由の一つ。
> あくまでも、内部用ドキュメントの話ね。外部に出すならワープロで作るのは構わないと思う。

たぶんOfficeの使い方を間違っている。というか使いこなしていない。
Wikiで書いた文章を配布するときはどうするんだ？HTMLで配布するのか？

110:デフォルトの名無しさん
03/10/29 09:04
>109
そのファイルが現物のDBを反映した物である保証があるならそれもアリですな。

>96
Officeに文書のバージョン管理の機能ってあるの?
是非教えてくれ。Officeを好きになれるかも。
配布に関しては別の話になると思うのだが・・・
まぁHTMLに吐くのもアリだしWikiによってはそのままPDF吐いてくれる物もあるし。

んで「テーブルレイアウト図」は一般的なんでしょうか。
気になって夜も眠れません・・・

111:デフォルトの名無しさん
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:デフォルトの名無しさん
03/10/30 00:28
>>110
カラムの名称や型や制約に関する記述はスキーマとかテーブル定義書って言うんじゃ
なかったっけ。テーブル間の関連を図示したものはＥＲＤだな。

116:110
03/10/30 08:45
>111
あ、そういう事か。
図を抜く訳ね。
てっきり「一般的にはみかんと呼ばれる物を俺のところではりんごと呼んでいた」
くらい違うのかと思ってた。
今後気をつける。

117:デフォルトの名無しさん
03/10/30 10:00
>>114
当然相手に応じて。

言われなければ俺は
回路図とかの図面はPDFにして
テキストで書ける事は全部ソースに全部埋め込む。

118:112
03/10/30 22:22
>>113
どうやんのって、持ってるならヘルプ見れよ！！！
今回だけだぞ、
[ファイル]－[版の管理...]

119:デフォルトの名無しさん
03/10/31 01:07
ドキュメントのメンテ工数もらえないうちらはどうすればよいでしょうか

120:デフォルトの名無しさん
03/10/31 12:07
その分別工程に上乗せ。

121:デフォルトの名無しさん
03/11/21 23:23
Doxygen Release 1.3.5 age

122:デフォルトの名無しさん
03/11/22 13:45
DoxygenでXHTMLを吐く上手い方法はないかね？

123:デフォルトの名無しさん
03/11/22 17:58
Doxygenの出力パーサを弄くるとか。
あれってC++だっけ？
Doxygenレベルのlexerが単体で使えれば楽になることが沢山あるんだが・・。

124:デフォルトの名無しさん
04/02/17 16:19
仕様書ってーか、目論見書つくらんといけなかったのですが、
windowsのアプリ完成後のイメージを作成するのに、
簡単にコントロールぺタぺタできるのありませんかね？
ＶＣのダイアログボックスも、ＶＢのダイアログボックスもめんどくさいとこあるし・・・。
どなたか良いのありましたら教えてください。

125:デフォルトの名無しさん
04/02/18 00:59
目論見書って、金融の目論見書しか知らないんだけど。

その目論見書？
それにWindows の UI を乗せる必要がある？

126:デフォルトの名無しさん
04/02/18 09:21
>>125
レスありがとうございます。

なんつーんでしょうかね？まぁ、こんなん作りますがみたいなのを他社に送るもんらしいです。
まぁ、中身も当然ですがＵＩの使いかってがかなり重要っぽいので・・・。
もう、フリーハンドでもいいとおもうんですけどね・・・。
とりあえず、今回はまぁそれなりに書いたんでどね。
次回以降ワードあたりでしこしこ線引くのも疲れるんで、なんか楽なの無いかな？と思いまして・・・。

127:デフォルトの名無しさん
04/02/18 20:18
Visioなら書けるが、VC・VBの方が楽。よってVisioでは無理。

128:デフォルトの名無しさん
04/02/18 21:45
>>127
wxWindowsのGUIツールキットBOAとかFOXとかFLTKあたりで作成できないもんかと思って、
とりあえず、暇できたらなんか色々チャレンジしてみます。
でも、.NET対応流行ったらどうすっぺ・・・。

129:デフォルトの名無しさん
04/02/18 22:36
FLTKは日本語まわりがアレ、wxWindowはちょっとDLLがデカイ
gtk+ 導入するのにものすごい壁がある。 Foxは知らん。
なんとなく実用的なものならwxWindowがいい、
でもどれでもポトペタは無理だと思う。

130:デフォルトの名無しさん
04/02/18 22:44
ポトペタってなに？

131:デフォルトの名無しさん
04/02/18 23:15
>>126
俺の会社の先輩はPowerPoint使ってデモしてました。
文字入力画面はできない(アニメーションでやってた)みたいだけど、
ボタンと画面表示はリンクで適当に作ってました。
全画面表示のアプリで、それっぽく見せてましたよ。

132:デフォルトの名無しさん
04/02/18 23:42
まぁVBが一番楽なんだろうね。

133:デフォルトの名無しさん
04/02/19 01:56
画面設計書じゃないから、それこそ"○○部分"と書いた枠の配置だけでいいと思う。
というか、そうでもして抽象化しないと完成画面だと思われる。

はっきりいえば、Windows の画面かどうかも分からないように書いたほうがいい。

134:デフォルトの名無しさん
04/02/19 06:20
もしもしTcl/Tkを忘れてますよ

135:124
04/02/19 09:35
>>129-134
みなさまどーもありとうございます。

>>129,132
ポトペタ（ポトッとおとしてペたって貼り付け？）は無理ですか。
ＶＢで適当につくるのがいいんですかね・・・。
でもおいらＶＢ苦手っす（なんかめんどいからかな？）。
超初心者用ページでいいページないですかね（スレ違い）。
C++ならそれなりにモウマンタイって感じなんですけど。

>>131
パワーポイントっすか。使ったことないですね。考慮してみます。

>>133
うーむ、画面設計書とかそこらへんの違いよくわからないです。
そういうのわかる書籍とかページありませんか？（スレ違い？）
とりあえず、今度は抽象化してだしてみますね。

>>134
あ、どもです。とあるページに載ってなかったもんでメジャーではないのかと思いまして。
（ここのＧＵＩスレには載ってますけど）

136:デフォルトの名無しさん
04/02/26 23:15
末端プログラマしかやったことないんですが、
ちょっとＰＭで設計書の類（まだはっきりしてないけど）を書く必要にせまられました。

で、役立つオススメな本あります？

137:デフォルトの名無しさん
04/02/27 22:42
まず、身の周りに先輩達が書いた設計書(見本)がないか探してみる。
なかったり、どうしようもないような代物なら…ガンガレ。

プログラム設計書　でぐぐると合うような物が見つかるかもよ。

138:デフォルトの名無しさん
04/02/27 22:47
周りに先輩達が書いた設計書(見本)がないか探してみる。
なかったり、どうしようもない代物だったら…ガンガレ。

プログラム設計書でぐぐる
要求定義からやる羽目になる罠もあるのでその辺もひっかけておく。

139:デフォルトの名無しさん
04/02/27 22:50
二重カキコ。逝って(ry
＿|￣|○

140:(゜Jし゜）
04/02/27 23:55
URLﾘﾝｸ(www.seshop.com)

このへんどうよ？

141:136
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）

URLﾘﾝｸ(pwiki.chbox.com)

URLﾘﾝｸ(bulkfeeds.net)

143:デフォルトの名無しさん
04/05/11 00:16
doxygen 1.3.7 age

144:デフォルトの名無しさん
04/07/18 17:51
詳細設計書は、プログラム処理の羅列でいいんだよね？

145:デフォルトの名無しさん
04/07/20 02:43
>プログラム処理の羅列

ダメ、それはプログラム設計書だNe!

146:デフォルトの名無しさん
04/07/25 19:54
doxygen 1.3.8 age

147:デフォルトの名無しさん
04/09/11 00:13:39
142さんありがとうございます。助かりました。
激遅レスだけど、感謝です。

148:あげ
04/09/25 05:02:40
doxygenで複数の言語向けのドキュメントを書くにはどうすればよいのだろう？

149:デフォルトの名無しさん
04/09/25 05:06:02
URLﾘﾝｸ(www.npb.or.jp)

150:148
04/09/25 05:09:09
すまん。
doxygen+"two languages"でぐぐったらマニュアルの\ifディレクティブの項に書いてある事が分かった。

151:デフォルトの名無しさん
04/09/28 16:09:35
保守

152:デフォルトの名無しさん
04/10/06 23:25:55
運用マニュアルや仕様書だの、どこか公的な書き方の決まりはあるんでしょうか。
例えばメニュー名などはどういう括弧でくくるのか、単語末の長音はない
方がいいとか、会社とかによってルールとかはあるとは思うんですが…。
でもまちまちだとどこか新しい営業先に提案書持っていくときだの、いろんな
会社のマニュアルを保管する側とかとまどったりするんじゃないかと
思うのですが、みなさんは普通に自分の周辺ルールで書いてますか？

153:デフォルトの名無しさん
04/10/07 01:12:28
doxygen 1.3.9 age

154:デフォルトの名無しさん
04/10/07 01:18:23
>>152
今までマニュアルや仕様書を（良い悪いに関わらず）読んできた経験に基づいて決める。
どこでも見かけるルールには従う。
あ、このルールいいな、と思ったものは取り入れてみる。
このルールだめじゃん、と思ったものは自分ではそうならないように気をつける。
ま、毒にも薬にもならん意見だな。

「ドキュメント」「標準」とかをキーに検索すれば？

155:デフォルトの名無しさん
04/10/07 23:01:14
俺も結局わからないまま、ウケよかったからいいか…とか
先例でいい奴とかまねしてるが、業界として共通の表現とかって
どっかないんかな…

156:デフォルトの名無しさん
04/10/07 23:10:44
この調子ではどうせ読む奴もわからないからいいんじゃない

157:デフォルトの名無しさん
04/10/08 06:09:48
どうせ誰も読まないから適当でいいんじゃない

158:デフォルトの名無しさん
04/10/13 00:00:55
doxygne 1.3.9.1 age

159:デフォルトの名無しさん
04/10/13 01:09:00
doxygenやJavaDocは多言語対応まで視野に含めると、どうかなと思ったり。

160:デフォルトの名無しさん
04/10/13 01:58:22
>>159 詳しく

161:デフォルトの名無しさん
04/10/13 07:55:33
>>159
INPUT_FILTER使えば？

162:デフォルトの名無しさん
04/10/13 17:55:43
俺ぐらいのレベルだと
ソースがドキュメント

163:デフォルトの名無しさん
04/10/13 17:56:44
ドキュメントが嘘ついている場合もあるのだ。

164:デフォルトの名無しさん
04/10/13 21:45:34
>>162のソースは嘘をついている

165:デフォルトの名無しさん
04/10/13 21:49:15
ソースがドキュメントと言っている奴のソースは大抵糞。
俺のソースはきれいだと腐ったソースで自分に酔ってる厨と同じ。

166:デフォルトの名無しさん
04/10/13 22:08:47
腐ったソースで走り出す♪
（プロジェクトが）

167:デフォルトの名無しさん
04/10/13 22:33:25
warota

168:Ruby!!!!!!!!!!!!!!
04/10/13 22:35:09
まつもとゆきひろ尊師は「ソースがドキュメント。バグもそこに記述されている」と仰いました。
おまえらひれ伏せ。

169:デフォルトの名無しさん
04/10/14 00:53:52
#if 0
ドキュメントはソースだけで十分です。
#endif

170:デフォルトの名無しさん
04/10/14 11:46:15
×ドキュメントはソースだけで十分です。
○ドキュメントはソースだけしかありません。

171:162==163
04/10/15 12:47:21
>>164-166
いや、
おれが、ドキュメント書かないわけじゃないよ。
一応気を使ってdoxygen対応で書いてるぜ。

で、
わかりにくいドキュメント見るぐらいなら、ソース見るって感じ。

ドキュメント読んで信じて、騙されるぐらいなら
ソースを読んだ方が正確。時間もさほど変わらない。←これが俺ぐらいのレベル

ソースが汚い奴のドキュメントは、
やっぱりわかりにくい罠ってのもある。

一応、EffectiveC++レベル以上のその系統の書籍を数冊読んでるし、
汚いソース何個も見てきたので
ある程度の読みやすいソース書く自信あるぜ。
そういう本読んでない初心者ちゃんにはきついかも。

172:デフォルトの名無しさん
04/10/15 15:14:32
ソースだけだと仕様なのか脆弱性なのかバグなのか区別がつかん。
ソース自体が読みやすいとか読みにくいとは全く別問題だし。

自分のソースにはバグは一切無いとか、
仕様のためのコードなのか、高速化のためのコードなのか、単にダメっぽいコードなのか、
みたいのを誰が見ても一目瞭然で区別できるとかいうなら話は別だが。

173:デフォルトの名無しさん
04/10/17 07:34:17
サルベージ

174:デフォルトの名無しさん
04/10/31 22:59:23
ドキュメントがメンテされてなくて役に立たん、というのはよくある話だ。

175:デフォルトの名無しさん
04/10/31 23:06:43
ドキュメント更新まで含めてコーディングすればいい

176:デフォルトの名無しさん
04/11/03 15:51:12
ドキュメントは古参ＳＥの頭の中だけってプロジェクトもあるよねえ（溜息）

177:デフォルトの名無しさん
04/11/23 20:57:53
今日Doxygen使い始めた。教科書はCマガジンの2002/8とDoxygenヘルプ。

*.hにコメント書くよりも*.cppに書いたほうが良い、というのは理解した。
(そりゃそーだわな)

でも、DLLなどのバイナリライブラリでソース見せたくないときは、
*.hに書くしかないような気がする。

*.cppに書いてあったコメントが、あたかも*.hに書いてあったように
Doxygenできる方法ってあるの？

それともローテクにリリース寸前でコメントを*.hにコピペするんか？

178:デフォルトの名無しさん
04/11/23 21:01:35
おれ177
まだまだ使い始めだからわかってないのかもしれないが、
要は、ソースが丸見えになるのがいやなのだ。
ソースを隠すオプションが探し切れていないだけなのかもしれん。

179:デフォルトの名無しさん
04/11/23 23:23:10
>>177
Doxygenした結果はcppに書いてあろうがhに書いてあろうが同じだと思うが。
ソース隠すオプションはある。

180:デフォルトの名無しさん
04/11/24 15:01:58
というかデフォルトで隠されてたような。
WindowsならDoxyWizard使うと楽チン。

181:デフォルトの名無しさん
04/11/24 19:01:47
おれ177
すまんかった、いろいろ試してみたらソース隠せたよ。
DoxyWizardは知らんかった、ちょっとさわってみる。

182:デフォルトの名無しさん
05/01/03 15:58:41
doxygne 1.4.0 age

183:ライブラリアン
05/01/03 16:36:26
ドキュメントってプログラミングする前に
書くものじゃないの。仕様書とか検査成績書とか。
プロはドキュメントを書いている時点で情報不足や矛盾が
わかるのでしょう。
プログラムを作ってからドキュメントを作るのは
最低だな。ゲーム少年の域をこえてないよ。

184:デフォルトの名無しさん
05/01/03 18:44:34
cppdocもソースやヘッダーの内容を文書化するのに使える

185:デフォルトの名無しさん
05/01/03 19:00:47
>>183 うるせーばか

186:デフォルトの名無しさん
05/01/03 21:42:33
>>183は真のゲーム少年

187:デフォルトの名無しさん
05/01/03 22:07:53
まず「ゲーム少年」というのが何だかよくわからないな

188:デフォルトの名無しさん
05/01/03 23:36:12
>>183
おいらのとこでは、プログラマが書くのは保守ドキュメントのほうが多い。
そうするとあとで書いたほうがいい。
同時にかくのはもっといい。
仕様書、成績書は別の人間が書く。
同じ人間がかくってことは零細？

189:デフォルトの名無しさん
05/01/03 23:38:38
零細の何が悪い

190:デフォルトの名無しさん
05/01/04 00:00:46
誰が書く、ということではなく
書く順番の話をしているのでは
ということは188は読解力ゼロ？

191:デフォルトの名無しさん
05/01/04 01:47:32
属人性MAX

192:188
05/01/04 23:28:28
>>190
プログラマの文書は保守文書が多かろうから
あとか同時に書くほうがいいし、あとが駄目とは
言い切れないんじゃないのということが言いたかった
ですよ。
んで、矛盾を見つかる仕様書は別の人が
書くだろうからそれで、非プロとはいかがなものかと。

>>189
悪くないけど大変ですね。

193:デフォルトの名無しさん
05/02/08 23:36:23

doxygenのLaTeX出力は鬼門だな

URLﾘﾝｸ(www.atmarkit.co.jp)
この辺のでｻﾝﾌﾟﾙは上手く逝ったが、漏れのソースだとｲﾋけ杉

194:デフォルトの名無しさん
05/02/09 15:13:57
要件定義書でのデータモデルって、良いお手本ありますかね？
概念モデルで。

195:デフォルトの名無しさん
05/04/09 19:20:51
doxygen 1.4.2 age

196:デフォルトの名無しさん
05/05/08 01:04:55
doxygenで、ローカル変数のコメントを出力するにはどうすりゃいいんすか？

int main(void){
　char s[BUFSIZE]; //!汎用バッファ
　↑こんなやつ。

197:デフォルトの名無しさん
05/05/08 01:11:53
>>196
ローカル変数を廃止して、全部グローバルにすればOK？

198:デフォルトの名無しさん
05/05/08 01:14:38
URLﾘﾝｸ(FLH1Ach124.kng.mesh.ad.jp)
ｗｗｗｗｗｗｗｗｗｗｗｗおｋｗｗｗうはっｗｗｗ
うぇｗｗｗ
おｋｗｗｗっっおｋｗｗｗｗｗｗｗｗｗｗ

ｗｗｗうぇｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗ

199:デフォルトの名無しさん
05/05/08 01:28:10
URLﾘﾝｸ(YahooBB219215164084.bbtec.net)
おｋｗｗｗっっおｋｗｗｗっうぇうぇｗｗｗ

うはっｗｗｗ
っｗｗｗｗｗｗｗｗｗｗｗｗ
っうぇｗｗｗｗｗｗ
うはっｗｗｗっうぇｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗ

200:デフォルトの名無しさん
05/05/08 23:37:07
>>196
そんなもの出力する必要あるの？

201:デフォルトの名無しさん
05/05/08 23:48:31
>>200
変数のドキュメントは必要でしょー

202:デフォルトの名無しさん
05/05/08 23:50:12
えーだってローカル変数だよ？
doxygenって、関数やクラスのインタフェースを記述するためのものじゃないの？

203:デフォルトの名無しさん
05/05/09 11:15:06
>>202
きめつけ：(･Ａ･)ｲｸﾅｲ

204:デフォルトの名無しさん
05/05/09 11:27:33
>>203
ローカル変数ってのは隠蔽されるべきものなので、
皆が読むドキュメントには書くべきではないと思われ。

実装者とか保守する人用に注意書き程度にコメント書くなら構わんと思うけど。

205:デフォルトの名無しさん
05/05/09 11:54:51
意味不明文書が大量生産されるのは
じつわ
ぜんぶmadeinusa
なので
それを
にほんごにするときに∞∴♂♀℃￥＄￠￡％＃＆＊＠§☆

206:デフォルトの名無しさん
05/05/09 12:07:04
URLﾘﾝｸ(ntchba046149.chba.nt.ftth.ppp.infoweb.ne.jp)

おｋｗｗｗうはっｗｗｗｗｗｗおｋｗｗｗ
ｗｗｗｗｗｗｗｗｗｗｗｗ
っうぇ
ｗｗｗｗｗｗｗｗｗｗｗｗ
うはっｗｗｗおｋｗｗｗｗｗｗｗｗｗｗｗｗｗっうぇ

207:デフォルトの名無しさん
05/05/10 00:19:54
>>204
保守用ドキュメントを作成し

208:デフォルトの名無しさん
05/05/10 02:08:45
>>207
普通は意味無いので

209:デフォルトの名無しさん
05/05/10 02:30:03
URLﾘﾝｸ(pl070.nas931.nara.nttpc.ne.jp)
ｗｗｗｗｗｗｗｗｗｗｗｗｗうはっｗｗｗｗｗｗｗｗ

ｗｗｗっｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗ
おｋｗｗｗ
うはっｗｗｗｗｗｗうぇｗｗｗ
ｗｗｗｗｗｗｗｗｗｗｗｗ

210:デフォルトの名無しさん
05/05/10 03:33:47
URLﾘﾝｸ(218.33.211.112.eo.eaccess.ne.jp)
おｋｗｗｗうぇｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗうはっｗｗｗ
うぇｗｗｗｗｗうはっｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗ
ｗｗｗｗｗｗｗｗｗｗうはっｗｗｗｗｗｗうぇｗｗｗ

211:デフォルトの名無しさん
05/05/11 08:37:36
↑あげると、こうなるので、上げないように。

212:デフォルトの名無しさん
05/05/11 20:58:44
だが断る

213:デフォルトの名無しさん
05/05/12 09:26:54
だがそれがいい

214:デフォルトの名無しさん
05/05/12 22:50:48
だが断る

215:デフォルトの名無しさん
05/05/13 09:19:26
だがそれがいい

216:デフォルトの名無しさん
05/05/13 18:14:50
俺たちの青春かよ！

217:デフォルトの名無しさん
05/05/15 00:34:54
おまいら、API仕様書とか書くときMS-WORDか？
ソースのひな形つくってdoxygenか？
なんか綺麗な方法ないか探し中の俺に教れろ。

218:デフォルトの名無しさん
05/05/15 01:00:18
>>217 doxygen 使っとけ。

219:デフォルトの名無しさん
05/05/17 01:13:37
doxygen 1.4.3 age

220:デフォルトの名無しさん
05/06/07 00:18:40
doxygen 使っとけ

221:デフォルトの名無しさん
05/06/12 01:55:49
DocBookとかDITAとか使ってる香具師いる？

222:デフォルトの名無しさん
05/06/12 12:15:26
いたらどうなんだよｗ

つーか、いねーよそんな奴(ﾌﾟｹﾞﾜﾛｳｽ

223:デフォルトの名無しさん
05/06/12 14:45:09
WORDで作るWebページって仕様になるのですかな？
目的はdoxygenにリンクさせて、一括管理しようと思ってます。（名づけて一元化）
WORDで作るとhtmlじゃなくhtmってなって、WORDで開いて.docにも変換可能です

質問はhtmって一般常識として普及しているのかどうかです
みなさんは、仕様を書くソフト（拡張子）は何を使ってますか？

224:デフォルトの名無しさん
05/06/12 14:51:50
>>223
テキストで管理して変換変換
.txt→.htm→.pdf と

225:デフォルトの名無しさん
05/06/12 15:10:03
>224
なるほど、テキスト最強ですな。
でもページ上でリンクしたいから、テキスト厳しいかも。
変な表とか入れずに、互換性上げるのには気をつけてます。

226:デフォルトの名無しさん
05/06/12 15:29:56
>>223
htmlをWORDで作るってのが個人的には好きではないが。

htmlは電子文書としては最強の一つだと思ってるよ。PDFよかぜんぜん好き。
仕様書は紙で出してナンボと思ってる古い業界体質も残ってるから
ウケはあまりよくないかも知れないけどね。

227:デフォルトの名無しさん
05/06/12 18:54:41
cssにしろXSLにしろ、理念は良いのだけど
どうせならもっと徹底して、テキストを完全に分離して欲しかったなぁ

テキスト側はもう生txtそのままでさ、
スタイルシート側は、面倒でも行で指定する感じ

実際は簡単なツールで補えば、行指定やテキスト変更も、手間でも無いだろうし

228:デフォルトの名無しさん
05/06/12 19:41:15
>>227
行指定は面倒すぎだろ
あと、その概念はWord文書みたいだ

229:デフォルトの名無しさん
05/06/12 20:26:40
>>227
確かに両方用意しないと行けない場合に便利だな。
頭の固いおっさん向けに、紙に印刷する必要がある時とか。

230:デフォルトの名無しさん
05/06/12 23:17:56
>>229 頭の柔軟な若者にも紙に印刷する必要があるだろ？

231:デフォルトの名無しさん
05/06/13 01:14:18
>>223

自分ならdoxygenでRTFで出力してpdfに変換して添付ファイルにするか、
WORDでRTFを開いてDOCに保存しなおすか。

RTFだとリンクはそのまま残るし、ドキュメントとしてもそれなりに
綺麗に出力されるからお勧め。一度試してみれ。

232:デフォルトの名無しさん
05/06/13 01:22:28
みなさんいろいろ言ってますが
それでお客に納品するの？
おいらは、Visioやパワーポイントも使わないようにしてるけど
打ち合わせ資料で使うときあるけど、最終的にはエクセルで書き直す事になる

233:223
05/06/13 01:31:32
>>231
ふむ、試してみます

234:デフォルトの名無しさん
05/06/13 03:52:03
XMLにコードとドキュメントを共存できる
XMLに対応したコンパイラ

235:デフォルトの名無しさん
05/06/13 11:35:27
>>234
XMLってマジで言ってますか？

236:デフォルトの名無しさん
05/06/13 20:30:41
>>234
XSLT使えばどうにでもなる気がする

237:デフォルトの名無しさん
05/06/14 13:26:23
つーかかつて Knuth というシトが
「文芸的プログラミング」(literary programming)
つーのを提唱して WEB つーシステムを開発したよね
それやりゃいいんだろ

238:デフォルトの名無しさん
05/06/14 21:01:39
　　　　　　　　　　 ,,ｒ'"　　　　　　　　　｀ヽ,、
　　　　　　　　　　　,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,｀￣｀　Ｖ　　￣　　 i::::i::::./　　な　上
　　　　　　　 V　l::::l,　　　　　　　　　 J /::::i "i/　　　ん　は
　　　　　　　　　ﾞl:::＼　　＿＿　　 ./l:::/ 　　　　　で
　　　　　　　　　　　　'!/　ヽ._ ヽ　ﾉ　,／" iv 　　　　す
　　　　　　　　　　　　　　＿.|｀ヽ- -イ|＿＜　　　　　　　　ﾟ
　　　　　　　　　　　　,,､ノ;;;;;;;|||||　 |||||;;;;;;;ヽ.｀!

SmartDocみたいな使えないものになるのが落ち

239:デフォルトの名無しさん
05/06/26 01:01:12
今のプロジェクトのドキュメントは
基本設計書からすべてExcelだ（´･ω･`）
確かに図を書くのがラクだけど・・・

240:デフォルトの名無しさん
05/06/26 17:00:24
質のいいスケルトンがあれば
Wordでもなんでもいいと思う

241:デフォルトの名無しさん
05/06/26 17:48:03
>>240
おれ、ワードは線がずれたら直せないんだよ。

242:デフォルトの名無しさん
05/06/26 17:52:50
>>241
根性、根性、ど根性

ちなみにIMEだとど根性で一単語になってる

243:デフォルトの名無しさん
05/06/27 03:53:01
IME

244:デフォルトの名無しさん
05/06/27 12:39:17
MS-IMEもATOKも「IME」だからな

245:デフォルトの名無しさん
05/06/28 11:06:46
MS-IMEがポピュラーになるまでは
FEPって方が通りがよかった。
だからついMS-IMEの事をIMEといってしまうま。

246:デフォルトの名無しさん
05/08/21 20:15:27
そんなことないよ

247:デフォルトの名無しさん
05/08/22 09:31:21
結局、仕様書書くのにどんなアプリつかっている？

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

htmlでやっているって言う人は、テキストエディタでごりごり書いているのだろうか？
ま、それが一番書きやすいのだが、そろそろhtmlエディタで良いのが出てきてほしいなあ。

248:デフォルトの名無しさん
05/08/22 19:05:24
マクロ使えるエクセルに決まってんじゃん
Wordは俺のUIと合わなかった

249:デフォルトの名無しさん
05/08/27 15:18:42
Wordは、いらぬお世話をするオプション類を全部OFFにして使えば使える。
挙動不審な事が多いし良く落ちるがドキュメントやマニュアルを書くのにはやっぱ
エクセルよりワードだな。

250:デフォルトの名無しさん
05/09/03 13:55:02
一度、どこかマ板辺りで
プログラマのためのワード講座
みたいなスレを立ててみようか

使いにくいと文句をいっている人は
例えるなら秀丸でVC++のソース編集してるようなもので
きちんと環境構築と突然死への備えを整えれば
VisualStudioなみの便利さを手に入れることはできる

251:デフォルトの名無しさん
05/09/10 01:05:56
僕は、LaTeXちゃん！

252:デフォルトの名無しさん
05/09/10 04:56:03
うちは何故かエクセル。開発環境はLinux＋Eclipseなのに、文章作成は
Windowsでエクセル（ﾟдﾟ）ﾎﾟｶｰﾝ
社内通達がエクセルで回って来た事もある。本文無しで添付ファイル
があるだけという、思わずゴミ箱に放りそうになったぞ。

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

誰もが納得するワードの利点とかあるなら聞きたい＞250

253:デフォルトの名無しさん
05/09/10 08:15:48
>>252
おぢさん達はExcelが大好きなのです。
日々の報告書からプレゼン資料まで、全部Excelで作ってくれます。
Wordは勝手に整形しやがるから使いにくいそうです。
罫線使いまくりの日本語文書はExcelの方が使いやすいんでしょう。

250じゃないが、誰もが納得するWordの利点：（取引先も含めて）みんなが使ってる

254:デフォルトの名無しさん
05/09/10 09:31:46
目次勝手につくってくれる

分厚い仕様書を方眼紙みたくしたエクセルで書かされて
目次の管理で死にました。

255:デフォルトの名無しさん
05/09/10 15:11:30
>>252
スタイル

なぜかあんまり使われていないようですが……

256:名無しさん＠そうだ選挙に行こう
05/09/10 19:01:51
>>252
エクセルだと表計算と図と文章作成、全てエクセル
でやろうと思えば済んでしまうらしいので、プレゼン資料
とかも全部エクセルだけにしてる奴がたまにいるｗ

257:名無しさん＠そうだ選挙に行こう
05/09/10 20:13:54
>>253
みんなが使ってる度ならExcelの方が上じゃない？
少なくともWordの方が一方的に有利って事はないと思う。

>>255
初めて聞いたｗ

>>256
最近、MindManager(MindMap)が大人気。
少し前はEA(UseCase)が大流行だったが
次は何が流行るんだろう？

258:名無しさん＠そうだ選挙に行こう
05/09/11 00:56:45
>>257
Wordのスタイル、少し覚えてみなよ。
マジデ便利だから。

259:名無しさん＠そうだ選挙に行こう
05/09/11 01:08:00
なんか興味が出てきてWordを立ち上げてみる
インストールして5年は経っているが、たぶんこれが起動2回目くらいだな

んでしばらくイジくってみたんだけど、テキストボックス使えればOKな感じでいいのかね？
他にめぼしい機能あるかな。些末なの抜きで。

260:名無しさん＠そうだ選挙に行こう
05/09/11 03:38:57
>>259
>些末なの抜きで。

Wordの売りはむしろ些末な機能が豊富にあるとこかもしれんｗｗｗ

261:名無しさん＠そうだ選挙に行こう
05/09/11 03:40:38
デフォ設定で自動補正になってなけりゃもっと評価高いかも
迷惑な便利機能を殺したくてその便利機能について学ぶという不毛な時間がすごくアレだ

262:名無しさん＠そうだ選挙に行こう
05/09/11 04:01:28
でも、ホント、Word の売りってなんなんだろうな？

パワポは俺も最近までは全然評価してなかったんだけど、会議で使う資料をパワポで作ったら、
いつもテキストファイルで書いてる内容と変わらんのに、妙に内容の評価がよくてﾜﾗﾀ。
やっぱり人は体裁で騙されるもんだなｗｗｗ　　・・・それからはパワポに一目置いている俺ｶﾞｲﾙ。

263:名無しさん＠そうだ選挙に行こう
05/09/11 11:27:31
>>262
発表において、体裁ってもんがどれほど重要か。
どんな小手先の技でもいいから、人の気を引くというのは大切よ。

Word の利点、ぱっと思いついたのだと、
- 修正履歴を残せる → 学生の論文チェックとかかなり楽
- コメントを付けれる → これも校正に凄く便利
- スペルチェック → 英文はとりあえず最初 Word で書いとけみたいな
- 一応、段落ごとにスタイル定義しておいて、スタイルの書式変更したら同じスタイル一斉に変更される

264:名無しさん＠そうだ選挙に行こう
05/09/11 13:27:47
Wordで20ページ↑の仕様書を書いてみればわかるよ
スタイルとかクロスリファレンスつけておくとマジ便利
目次や索引も自動で作れるし。
これでもう少し図形描画の機能が充実してればなぁ・・・
ま、そっちはVisio使ってるからいいんだけど。

#でも、個人的にはLaTexを吐いてくれるエディタが欲しいところ

265:名無しさん＠そうだ選挙に行こう
05/09/11 13:29:26
利点
- 目次作成 + 自動更新
- 図表番号の自動更新

266:名無しさん＠そうだ選挙に行こう
05/09/11 17:20:24
>>263-265

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

XSLTが大好きな俺的にはXML形式に対応してるところなんかが蝶最高なんだけど、
これはExcelやパワポでもできることだしな。

267:名無しさん＠そうだ選挙に行こう
05/09/11 17:33:54
Wordの最大のウリは
多数派であるということ

268:名無しさん＠そうだ選挙に行こう
05/09/11 17:50:31
>>264
最近のはマシなんか？
Wordでページ数多い文書作ると重いわすぐ落ちるわで……
いい印象無かったんだが

269:名無しさん＠そうだ選挙に行こう
05/09/11 18:28:11
>>264-265
この辺のテンプレート集とかスクリプト集ってある？
折角の利点も簡便で分かり易くないと説得が難しい。
偉いさんてのはプライドを刺激されると意固地になるからな。彼らは難しいとか
理解できないを決して口にせず、それらを必要がないの一言で片付けてしまう。

270:名無しさん＠そうだ選挙に行こう
05/09/11 18:32:51
>>267
Excelの方が多数派だよ？
総務などの非生産部門には必ずと言っていいほどExcelが導入されてるから

271:名無しさん＠そうだ選挙に行こう
05/09/11 18:33:14
>>269
目次だのなんだのって、単なるWordの基本機能だから、スクリプトは不要だよ。
ちゃんとスタイル使って（「見出し1」とか「見出し2」とか）文書を
書けば、章番号を自動で振ってくれるし、後でそれをもとに自動で目次が作れる。

272:名無しさん＠そうだ選挙に行こう
05/09/11 18:34:18
>>270
ExcelとWordでは用途が違うというだけの話だ。
適材適所で使い分けるのが賢いやり方。

273:名無しさん＠そうだ選挙に行こう
05/09/11 18:51:04
>>271
ありゃ？そうなのか、て言うか基本機能なのかよ！
俺自身が実際に触って、基本機能くらいは理解しないと話にもならんな＿|￣|○|||
それが何とも億劫と言えば億劫なんだが……
俺も偉いさんの事をとやかくは言えんな……

>>272
問題は、決して賢くないという点だ！Σ(´Д｀）

274:名無しさん＠そうだ選挙に行こう
05/09/11 19:02:01
>>273
URLﾘﾝｸ(www.amazon.co.jp)
この本がおすすめ。

アウトラインモードで取り敢えず書くのが
自然に思えてきたら結構使ってる人なんじゃないでしょか。

275:名無しさん＠そうだ選挙に行こう
05/09/11 21:47:06
>>273
俺、元々LaTeX派だったけど、3日でWordに転向しちゃったよ。
割とすぐ覚えれる。

276:名無しさん＠そうだ選挙に行こう
05/09/11 21:50:52
>>274

この本、自分も人から薦められて買ったけど、かなりいい本ですね。
職場に一冊常備すべし。

277:名無しさん＠そうだ選挙に行こう
05/09/11 22:54:18
Win板かソフ板の話題が続いている件について

278:デフォルトの名無しさん
05/09/12 00:35:07
>>274-276
ホントかよ？ジエリじゃねぇだろうなｗ
とりあえず明日本屋行ってくるよ。初心者向けではないみたいだから
一緒に入門書も買ってくる。

279:デフォルトの名無しさん
05/09/12 00:59:59
>>278
じえんじゃないよ。
まあじえんだとしてもいいじゃん
本屋で立ち読みしてみて決めてちょー。

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

DTPのマナーみたいな話も、システム文書には
必要ないけど、面白かったな。

280:デフォルトの名無しさん
05/09/16 00:55:41
Wordのスタイル機能は書式をいぢりづらいのがネック。
特にスタイル使わずに書かれた文章にスタイルを導入しようとすると死ねる。

281:デフォルトの名無しさん
05/09/16 10:45:36
>>280
あとからは相当骨でしょそりゃー。

282:デフォルトの名無しさん
05/09/23 00:26:28
なんかMSワードって何処でも決まって悪者にされる傾向があるけどなんでだろうね。
俺はかなり良いソフトだと思うんだけど。いやマジで。

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

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

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

それにしても、ワード貶してる奴らに関しては、ワードの問題というより
そいつらの能力の問題じゃないかと思うが。

283:デフォルトの名無しさん
05/09/23 01:07:59
デフォルト設定のせい
UNIXが使いにくいのとおなじ

284:デフォルトの名無しさん
05/09/23 11:01:41
それにしても、UNIX貶してる奴らに関しては、UNIXの問題というより
そいつらの能力の問題じゃないかと思うが。

285:デフォルトの名無しさん
05/09/23 14:04:57
じゃあWordに文句を言うやつも無能だな。

286:デフォルトの名無しさん
05/10/10 16:31:55
>>285
そりゃ無能だろ

287:デフォルトの名無しさん
05/10/10 17:27:01
あーでもWordの使いにくさとUNIXの使いにくさは別だな。
UNIXはどうしようもないからな。

288:デフォルトの名無しさん
05/10/10 17:33:25
doxygen 1.4.5 age

289:デフォルトの名無しさん
05/10/10 17:34:07
なんで並列に語ってるのか知らないけどあえてノルなら
Wordの使いにくさは袋小路であり、UNIXの使いにくさは迷路だ。

Wordでやりたいことをやるとき、正式な方法が無いことはよくあり
正式じゃない方法で突破することが多い
UNIXでやりたいことをやるとき、正式な方法がそもそも難解で
そのことを訴えると「道があるんだからいいだろ」と突っぱねる

290:デフォルトの名無しさん
05/10/10 18:29:51
Linuxの場合、とっつきやすさや使いやすさを最初から目指していないのだから使いにくくて当然な気がする。
Wordはなー。MSってUIにけっこう力入れてるはずなのになんであんなことになるのか。

291:デフォルトの名無しさん
05/10/10 19:38:35
英文だと一般の評判多少マシなのか？

292:デフォルトの名無しさん
05/10/11 11:07:21
ドキュメンテーションを書くときは常に例を書き込むとかなりグー。
PHPのドキュメンテーションなんていい例じゃないかな。
使い方系のドキュメンテーションはシナリオ書いとく。

ところで、結局Wiki立てても書くのは結局一人だけだよなぁ。
でもみんなで書くという機能よりも手軽にどこからでも書けるというのが気に入ってる。
使いこなすとかなり快適。あとはVISIOでちょっと図を描いて終了。

293:デフォルトの名無しさん
05/10/27 03:40:16
確かにリファレンスとかは、
動作例ある方が読みやすいもんな。

つーか動作例無いと、リファレンスに見えないというか。

294:デフォルトの名無しさん
05/11/01 01:47:40
ドキュメントなんか書いてる暇があったらソースを書け。

295:デフォルトの名無しさん
05/11/06 15:48:48
概要仕様はワープロソフトできっちり作るな。納品しやすいし。
細かい仕様はソースにコメント埋めまくり。

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

何か一つだけしか覚えられない香具師がエクセル使っている感が有るな。
自由紙、原稿用紙、レポート用紙、方眼用紙っていろいろあるけど、どれか一つ選べって状態で方眼紙選んじゃってるだけだ。
レポート用紙にグラフも書けるのにさ。

296:デフォルトの名無しさん
05/11/11 16:36:53
どのソフトを使うかなんか関係ないって。中身ですよ中身。
つーか、こんだけソフト開発が行われてるんだから、もちっとドキュメント作成技術も洗練されていてくると思うんだけどな～。
どこのプロジェクト行っても、読まれない＆読んでも意味ないドキュメントばっか。
新規で起こす時も役にたたねぇだろうなーと思いつつ作ってるし。

それともオレが知らないだけで、既に良いツールor作成理論とかあったりするの？
もしあったら教えてエロイひと

297:デフォルトの名無しさん
05/11/11 22:53:22
>>296
コツを教えてあげるよ

自分が欲しいと思えるドキュメントを作ればいいよ
役に立つように作るべし
役に立たないと思った個所はどんどん削除

298:デフォルトの名無しさん
05/11/11 22:55:25
あと、起承転結では読みづらいので起結承転を心がけること

299:デフォルトの名無しさん
05/11/11 23:11:01
正直「転」はいらん。

300:デフォルトの名無しさん
05/11/11 23:23:41
統合設計書作成アプリケーション作って。
普通のアプリでWikiっぽい機能＋Wordの章番管理＋Excelみたいな表が
自由に作れる幹事で

301:デフォルトの名無しさん
05/11/12 08:19:16
転ってアレか。

この関数は○○の機能を持つ <- 起結
ただし、××の副作用を持つ <- 承転

302:デフォルトの名無しさん
05/11/12 17:11:51
さすがにtxtを推奨する奴はいないようだ。

303:296
05/11/14 09:43:53
いや、ドキュメント書けないわけじゃないないけどね。
この業界、結局ウォーターフォール型がほとんどじゃない？
だったら　要求＞仕様＞設計＞試験　ぐらいのテンプレートとか支援ツールあってもいいんじゃねーかなと思って。
それに有名な規格ができたら、顧客の理解度、満足度ももっと高くならないかなぁ。とか
（Rational Rose とかは勘弁な。”UML図”だけじゃレビュー通らないし）

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

あ～ぐだぐだと駄文書いてスマヌ

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

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

なんか仕様書とあまり変わらないか。
でも言葉とかフォーマットとか、もっとお客さんに優しい感じ。

305:デフォルトの名無しさん
05/11/14 13:50:36
納品物としての仕様書は、
質重視ではなく量重視だな。

次ページ