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

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

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
納品物としての仕様書は、
質重視ではなく量重視だな。

306:デフォルトの名無しさん
05/11/14 15:40:39
すると普通の仕様書より表現が冗長になりそうな
マニュアルでの納品がやっぱいいな
スクリーンショットわんさかで

307:デフォルトの名無しさん
05/11/14 21:10:06
>>301
そんな感じ
注意事項

308:デフォルトの名無しさん
05/11/15 01:24:59
>>306
マニュアル + クラス仕様書(自動生成したもの) が最強。
そして両面印刷なんてもってのほか。

309:デフォルトの名無しさん
05/11/29 03:00:58
>>254
亀レスすまそ。

よくExcelのセルを方眼紙みたい（正方形）にする人がいるんだけど、
あれって何が便利であんなセルにしちゃうわけ？
レイアウトしやすいってだけ？

310:デフォルトの名無しさん
05/11/29 10:04:30
本当に方眼紙に仕様書を書いてた名残らしい。
あと、インデントしやすいからといってた。

311:309
05/11/30 18:12:53
>>310
方眼紙ってそのまんまかいなｗ

312:デフォルトの名無しさん
05/12/31 19:33:11
doxygen 1.4.6 age

313:デフォルトの名無しさん
05/12/31 20:00:13
wiki風の装飾付きtxtを書いて、自前ツール通してhtmlにしてるな。
リンクやレイアウトが簡単だし、ブラウザは誰でも入ってるから。

314:デフォルトの名無しさん
06/01/25 17:59:27
doxygenのマニュアル読んでも、「使わねー」とか「ソース汚なくなるだけー」
みたいなコマンド(キーワードや記法)が多いと思ったんだけど、どう？
おまいらのdoxygenボキャブラリーはどんなもんよ？

315:デフォルトの名無しさん
06/01/25 22:45:51
file brief author
pre post param return retval
後メンバグループにname { }

316:デフォルトの名無しさん
06/01/27 09:26:58
>>315
それだけあれば、ひととおりの仕様は説明できそうだよね。
「意見」なんかを入れはじめるとややこしくなるんだよね。

317:デフォルトの名無しさん
06/02/25 02:38:32
ドキュメントが書けないやつは自分の頭でわかってないからだ。
自分ではわかってるけど説明するのが下手というやつは、自分でも
わかってない。それは直感と連想能力とヒントでピントでプログラミング
してるだけだ。

318:デフォルトの名無しさん
06/02/25 11:59:02
16分割の最初の2枚ぐらいでわかっちゃうようなやつには
ドキュメント作成なんてまだるっこしくってやってられんのだろうな。
馬鹿の気持ちが分からないから、標準からはずれたのを作成してしまう。

医者なんかでもそうだけど、臨床とかエンドユーザーが絡む作業は
あんまり頭が切れるヤツは向いてなくて、
ちょっと馬鹿だけどそれを自覚して慎重・着実に作業する
ヤツの方が向いてる。

319:デフォルトの名無しさん
06/03/04 02:25:09
ソフトウェア開発の世界標準フォーマットみたいなもの無いかな
各工程で何の文書が必要で、どのような項目を記載するものだ、みたいな

320:デフォルトの名無しさん
06/03/32 17:58:17
UMLって客に見せても実際は理解してもらえない。
客側に上級シスアドみたいなのがいれば話は別だが、現在ではそんな状況はあまりない。
結局UMLで書くってのは設計者のオナニーなんだなと思う。
なにしろUML試験なんかあるくらいだから、コンピュータど素人のお客にわかりやすいわけがない。

ところでXP開発におけるドキュメントの生成の仕方ってどうしてる？
うちは要件定義書が文章じゃなくて業務フローのの図だけなんだが。
そんなのが入力では詳細設計書なんて書けないぜ。

321:デフォルトの名無しさん
06/03/32 18:31:53
UMLは客に理解してもらうためのもの、
なんて言ってる人はあなた以外に見たことありませんけどw

自分が勝手に銀の弾丸を求めてるだけでしょ？
銀の弾丸がきっとあるに違いないと無意識に思ってるから
ネジ廻しがネジを締めることにしか使えないことに苛立つんだよ。

322:デフォルトの名無しさん
06/03/32 18:57:02
＞UMLは客に理解してもらうためのもの、
＞なんて言ってる人はあなた以外に見たことありませんけどw

見聞が狭いんだね。俺は何人か知ってるよ。
見たこともない、とは重傷だな。

323:デフォルトの名無しさん
06/03/32 20:35:16
ダメなドキュメントってあるよね。当たり前のことしか書いてなくて、
ポイントが抑えられてないような。
UMLだろうがワードだろうが、同じ人間が書く限りダメなドキュメントなのは変わらないのが現実

324:デフォルトの名無しさん
06/03/32 23:02:48
ドキュンメント

325:デフォルトの名無しさん
06/04/09 00:06:13
みんなはdoxygenでコメント書くとき
Qtスタイルにしてます？JavaDocスタイルにしてます？

326:デフォルトの名無しさん
06/04/09 17:17:32
JavaDoc スタイル。
Qt ってマイナーだし Qt にするメリットってあるの？

327:デフォルトの名無しさん
06/04/09 20:37:45
>>320
むつかしく書きすぎ、細かく書きすぎ
なんじゃないの？

328:デフォルトの名無しさん
06/04/09 21:42:04
言われてみればそうだよな…・。
伝えるだけなら、
紙に手書きしてコピったりスキャナで取り込むなりの方が遥かに敏速。

329:デフォルトの名無しさん
06/04/10 03:00:04
>>319
それこそ本屋にいけば山ほどその手の本があるやん。
成果物が一番はっきり明示されているのはラショナル統一プロセス
じゃないの。ISO9001なんかを取得している会社なら社内標準で
成果物が設定されているでしょ。

>>320
オブジェクト指向言語で開発しているなら、それとの親和性の
高さという点から、内部設計はUMLでするのはいい。けど、
要求仕様をユースケースなんかで顧客に見せるやつの気が知れない。
というかそういうやついるのか？俺はずっと前からアンチユース
ケース派でそういうことばっかり言っているけど。

330:329
06/04/10 03:02:49
>>319
それと追記するけど、どんな職場や環境、メンバーのスキルに
合致した魔法の世界標準フォーマットは存在するわけがない。

それぞれに合致したものはそれぞれが苦労して考えるしかない。
参考にするのはいいけど、巷に出回っている開発プロセスを
そのままやろうとすると失敗するよ。

331:デフォルトの名無しさん
06/04/18 15:12:14
質問。

仕様書だけ書いて、それを
ベクターみたいに、アップロードして
みんなに見せるサイトって、どこかある？

332:デフォルトの名無しさん
06/04/18 15:15:33
参考。仕様書相互リンク

良いドキュメント・マニュアル・仕様書を書くスレ
ｽﾚﾘﾝｸ(tech板)

小規模開発では仕様書は作るだけ無駄
ｽﾚﾘﾝｸ(prog板)

AJAX時代の仕様書とは
ｽﾚﾘﾝｸ(tech板)

営業が作った仕様書に
ｽﾚﾘﾝｸ(prog板)

良い仕様書、悪い仕様書、普通の仕様書
ｽﾚﾘﾝｸ(prog板)

プログラマ経験がないのに仕様書を作成
ｽﾚﾘﾝｸ(prog板)

仕様書の量でしか成果を決められない客
ｽﾚﾘﾝｸ(prog板)

Excelで仕様書を作る会社の奴の数→
ｽﾚﾘﾝｸ(prog板)

次ページ