- 1 名前：デフォルトの名無しさん [03/10/05 23:34]
- おまえら、自分で作ったプログラムについての、わかりやすく的確な
ドキュメントを書ける自信はあるか？
仕事で納品したり、他人に見せるプログラムとして公開するつもりなら、
マニュアルや、仕様書などのドキュメントを書く機会は必ずある。
プログラムとドキュメントはとても関係が深い。ドキュメントが整っていない
プログラムなど、ゴミと同じ。それに、ただ書けばいいって物でもない。
ドキュメントがゴミ程の役にも立たなければ、結局それはゴミなのだ。
だらだらと書いた意味不明な文章を他人に見られるのも恥ずかしいよな？
いわばドキュメントを書く技術はプログラマの必須スキルの１つなのだが、
実際は、下手糞なドキュメントが蔓延っている。(これはGNU製に多い)
読んでも無駄とか、書いても無駄とか思ってる奴、その考えを改めろ。
プログラムに対するドキュメントを、ちゃんとした１作品として、
後世に残せるよう努力すべきだろう。
今一度問う。
おまえら、わかりやすく的確なドキュメントを書ける自信はあるか？
- 207 名前：デフォルトの名無しさん mailto:sage [2005/05/10(火) 00:19:54 ]
- >>204
保守用ドキュメントを作成し
- 208 名前：デフォルトの名無しさん [2005/05/10(火) 02:08:45 ]
- >>207
普通は意味無いので
- 209 名前：デフォルトの名無しさん [2005/05/10(火) 02:30:03 ]
- pl070.nas931.nara.nttpc.ne.jp/
ｗｗｗｗｗｗｗｗｗｗｗｗｗうはっｗｗｗｗｗｗｗｗ
ｗｗｗっｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗ
おｋｗｗｗ
うはっｗｗｗｗｗｗうぇｗｗｗ
ｗｗｗｗｗｗｗｗｗｗｗｗ
- 210 名前：デフォルトの名無しさん [2005/05/10(火) 03:33:47 ]
- 218.33.211.112.eo.eaccess.ne.jp/
おｋｗｗｗうぇｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗうはっｗｗｗ
うぇｗｗｗｗｗうはっｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗ
ｗｗｗｗｗｗｗｗｗｗうはっｗｗｗｗｗｗうぇｗｗｗ
- 211 名前：デフォルトの名無しさん mailto:sage [2005/05/11(水) 08:37:36 ]
- ↑あげると、こうなるので、上げないように。
- 212 名前：デフォルトの名無しさん mailto:sage [2005/05/11(水) 20:58:44 ]
- だが断る
- 213 名前：デフォルトの名無しさん mailto:sage [2005/05/12(木) 09:26:54 ]
- だがそれがいい
- 214 名前：デフォルトの名無しさん mailto:sage [2005/05/12(木) 22:50:48 ]
- だが断る
- 215 名前：デフォルトの名無しさん mailto:sage [2005/05/13(金) 09:19:26 ]
- だがそれがいい
- 216 名前：デフォルトの名無しさん mailto:sage [2005/05/13(金) 18:14:50 ]
- 俺たちの青春かよ！
- 217 名前：デフォルトの名無しさん [2005/05/15(日) 00:34:54 ]
- おまいら、API仕様書とか書くときMS-WORDか？
ソースのひな形つくってdoxygenか？
なんか綺麗な方法ないか探し中の俺に教れろ。
- 218 名前：デフォルトの名無しさん mailto:sage [2005/05/15(日) 01:00:18 ]
- >>217 doxygen 使っとけ。
- 219 名前：デフォルトの名無しさん [2005/05/17(火) 01:13:37 ]
- doxygen 1.4.3 age
- 220 名前：デフォルトの名無しさん mailto:age [2005/06/07(火) 00:18:40 ]
- doxygen 使っとけ
- 221 名前：デフォルトの名無しさん [2005/06/12(日) 01:55:49 ]
- DocBookとかDITAとか使ってる香具師いる？
- 222 名前：デフォルトの名無しさん mailto:sage [2005/06/12(日) 12:15:26 ]
- いたらどうなんだよｗ
つーか、いねーよそんな奴(ﾌﾟｹﾞﾜﾛｳｽ
- 223 名前：デフォルトの名無しさん mailto:sage [2005/06/12(日) 14:45:09 ]
- WORDで作るWebページって仕様になるのですかな？
目的はdoxygenにリンクさせて、一括管理しようと思ってます。（名づけて一元化）
WORDで作るとhtmlじゃなくhtmってなって、WORDで開いて.docにも変換可能です
質問はhtmって一般常識として普及しているのかどうかです
みなさんは、仕様を書くソフト（拡張子）は何を使ってますか？
- 224 名前：デフォルトの名無しさん mailto:sage [2005/06/12(日) 14:51:50 ]
- >>223
テキストで管理して変換変換
.txt→.htm→.pdf と
- 225 名前：デフォルトの名無しさん mailto:sage [2005/06/12(日) 15:10:03 ]
- >224
なるほど、テキスト最強ですな。
でもページ上でリンクしたいから、テキスト厳しいかも。
変な表とか入れずに、互換性上げるのには気をつけてます。
- 226 名前：デフォルトの名無しさん mailto:sage [2005/06/12(日) 15:29:56 ]
- >>223
htmlをWORDで作るってのが個人的には好きではないが。
htmlは電子文書としては最強の一つだと思ってるよ。PDFよかぜんぜん好き。
仕様書は紙で出してナンボと思ってる古い業界体質も残ってるから
ウケはあまりよくないかも知れないけどね。
- 227 名前：デフォルトの名無しさん mailto:sage [2005/06/12(日) 18:54:41 ]
- cssにしろXSLにしろ、理念は良いのだけど
どうせならもっと徹底して、テキストを完全に分離して欲しかったなぁ
テキスト側はもう生txtそのままでさ、
スタイルシート側は、面倒でも行で指定する感じ
実際は簡単なツールで補えば、行指定やテキスト変更も、手間でも無いだろうし
- 228 名前：デフォルトの名無しさん mailto:sage [2005/06/12(日) 19:41:15 ]
- >>227
行指定は面倒すぎだろ
あと、その概念はWord文書みたいだ
- 229 名前：デフォルトの名無しさん mailto:sage [2005/06/12(日) 20:26:40 ]
- >>227
確かに両方用意しないと行けない場合に便利だな。
頭の固いおっさん向けに、紙に印刷する必要がある時とか。
- 230 名前：デフォルトの名無しさん [2005/06/12(日) 23:17:56 ]
- >>229 頭の柔軟な若者にも紙に印刷する必要があるだろ？
- 231 名前：デフォルトの名無しさん [2005/06/13(月) 01:14:18 ]
- >>223
自分ならdoxygenでRTFで出力してpdfに変換して添付ファイルにするか、
WORDでRTFを開いてDOCに保存しなおすか。
RTFだとリンクはそのまま残るし、ドキュメントとしてもそれなりに
綺麗に出力されるからお勧め。一度試してみれ。
- 232 名前：デフォルトの名無しさん mailto:sage [2005/06/13(月) 01:22:28 ]
- みなさんいろいろ言ってますが
それでお客に納品するの？
おいらは、Visioやパワーポイントも使わないようにしてるけど
打ち合わせ資料で使うときあるけど、最終的にはエクセルで書き直す事になる
- 233 名前：223 mailto:sage [2005/06/13(月) 01:31:32 ]
- >>231
ふむ、試してみます
- 234 名前：デフォルトの名無しさん mailto:sage [2005/06/13(月) 03:52:03 ]
- XMLにコードとドキュメントを共存できる
XMLに対応したコンパイラ
- 235 名前：デフォルトの名無しさん mailto:sage [2005/06/13(月) 11:35:27 ]
- >>234
XMLってマジで言ってますか？
- 236 名前：デフォルトの名無しさん mailto:sage [2005/06/13(月) 20:30:41 ]
- >>234
XSLT使えばどうにでもなる気がする
- 237 名前：デフォルトの名無しさん [2005/06/14(火) 13:26:23 ]
- つーかかつて Knuth というシトが
「文芸的プログラミング」(literary programming)
つーのを提唱して WEB つーシステムを開発したよね
それやりゃいいんだろ
- 238 名前：デフォルトの名無しさん mailto:sage [2005/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 名前：デフォルトの名無しさん [2005/06/26(日) 01:01:12 ]
- 今のプロジェクトのドキュメントは
基本設計書からすべてExcelだ（´･ω･`）
確かに図を書くのがラクだけど・・・
- 240 名前：デフォルトの名無しさん [2005/06/26(日) 17:00:24 ]
- 質のいいスケルトンがあれば
Wordでもなんでもいいと思う
- 241 名前：デフォルトの名無しさん mailto:sage [2005/06/26(日) 17:48:03 ]
- >>240
おれ、ワードは線がずれたら直せないんだよ。
- 242 名前：デフォルトの名無しさん mailto:sage [2005/06/26(日) 17:52:50 ]
- >>241
根性、根性、ど根性
ちなみにIMEだと ど根性 で一単語になってる
- 243 名前：デフォルトの名無しさん mailto:sage [2005/06/27(月) 03:53:01 ]
- IME
- 244 名前：デフォルトの名無しさん mailto:sage [2005/06/27(月) 12:39:17 ]
- MS-IMEもATOKも「IME」だからな
- 245 名前：デフォルトの名無しさん mailto:sage [2005/06/28(火) 11:06:46 ]
- MS-IMEがポピュラーになるまでは
FEPって方が通りがよかった。
だからついMS-IMEの事をIMEといってしまうま。
- 246 名前：デフォルトの名無しさん [2005/08/21(日) 20:15:27 ]
- そんなことないよ
- 247 名前：デフォルトの名無しさん [2005/08/22(月) 09:31:21 ]
- 結局、仕様書書くのにどんなアプリつかっている？
俺の場合
図や表、文をまぜこみの仕様書である程度見栄えも気にする場合は、
OpenOfficeOrg2.0Betaを使っている。
Wordは俺は受け付けることができなかったが、Oooはなんとか好きになれそう。
htmlでやっているって言う人は、テキストエディタでごりごり書いているのだろうか？
ま、それが一番書きやすいのだが、そろそろhtmlエディタで良いのが出てきてほしいなあ。
- 248 名前：デフォルトの名無しさん mailto:sage [2005/08/22(月) 19:05:24 ]
- マクロ使えるエクセルに決まってんじゃん
Wordは俺のUIと合わなかった
- 249 名前：デフォルトの名無しさん mailto:sage [2005/08/27(土) 15:18:42 ]
- Wordは、いらぬお世話をするオプション類を全部OFFにして使えば使える。
挙動不審な事が多いし良く落ちるがドキュメントやマニュアルを書くのにはやっぱ
エクセルよりワードだな。
- 250 名前：デフォルトの名無しさん mailto:sage [2005/09/03(土) 13:55:02 ]
- 一度、どこかマ板辺りで
プログラマのためのワード講座
みたいなスレを立ててみようか
使いにくいと文句をいっている人は
例えるなら秀丸でVC++のソース編集してるようなもので
きちんと環境構築と突然死への備えを整えれば
VisualStudioなみの便利さを手に入れることはできる
- 251 名前：デフォルトの名無しさん mailto:sage [2005/09/10(土) 01:05:56 ]
- 僕は、LaTeXちゃん！
- 252 名前：デフォルトの名無しさん mailto:sage [2005/09/10(土) 04:56:03 ]
- うちは何故かエクセル。開発環境はLinux＋Eclipseなのに、文章作成は
Windowsでエクセル（ ﾟдﾟ）ﾎﾟｶｰﾝ
社内通達がエクセルで回って来た事もある。本文無しで添付ファイル
があるだけという、思わずゴミ箱に放りそうになったぞ。
それはそれとして、前に文章作成なのに何故エクセル？という問いを
投げてみたんだが、エクセルで何の問題がある？と聞き返されて有耶
無耶になった。
ワードを使えば云々と言えるほど、俺はオフィスツール知らんからな。
て言うか、正直エクセルも線の引き方と文字の属性変更くらいしか知
らんのだけどねorz
誰もが納得するワードの利点とかあるなら聞きたい＞250
- 253 名前：デフォルトの名無しさん mailto:sage [2005/09/10(土) 08:15:48 ]
- >>252
おぢさん達はExcelが大好きなのです。
日々の報告書からプレゼン資料まで、全部Excelで作ってくれます。
Wordは勝手に整形しやがるから使いにくいそうです。
罫線使いまくりの日本語文書はExcelの方が使いやすいんでしょう。
250じゃないが、誰もが納得するWordの利点： （取引先も含めて）みんなが使ってる
- 254 名前：デフォルトの名無しさん mailto:sage [2005/09/10(土) 09:31:46 ]
- 目次勝手につくってくれる
分厚い仕様書を方眼紙みたくしたエクセルで書かされて
目次の管理で死にました。
- 255 名前：デフォルトの名無しさん mailto:sage [2005/09/10(土) 15:11:30 ]
- >>252
スタイル
なぜかあんまり使われていないようですが……
- 256 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/10(土) 19:01:51 ]
- >>252
エクセルだと表計算と図と文章作成、全てエクセル
でやろうと思えば済んでしまうらしいので、プレゼン資料
とかも全部エクセルだけにしてる奴がたまにいるｗ
- 257 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/10(土) 20:13:54 ]
- >>253
みんなが使ってる度ならExcelの方が上じゃない？
少なくともWordの方が一方的に有利って事はないと思う。
>>255
初めて聞いたｗ
>>256
最近、MindManager(MindMap)が大人気。
少し前はEA(UseCase)が大流行だったが
次は何が流行るんだろう？
- 258 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 00:56:45 ]
- >>257
Wordのスタイル、少し覚えてみなよ。
マジデ便利だから。
- 259 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 01:08:00 ]
- なんか興味が出てきてWordを立ち上げてみる
インストールして5年は経っているが、たぶんこれが起動2回目くらいだな
んでしばらくイジくってみたんだけど、テキストボックス使えればOKな感じでいいのかね？
他にめぼしい機能あるかな。些末なの抜きで。
- 260 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 03:38:57 ]
- >>259
>些末なの抜きで。
Wordの売りはむしろ些末な機能が豊富にあるとこかもしれんｗｗｗ
- 261 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 03:40:38 ]
- デフォ設定で自動補正になってなけりゃもっと評価高いかも
迷惑な便利機能を殺したくてその便利機能について学ぶという不毛な時間がすごくアレだ
- 262 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 04:01:28 ]
- でも、ホント、Word の売りってなんなんだろうな？
パワポは俺も最近までは全然評価してなかったんだけど、会議で使う資料をパワポで作ったら、
いつもテキストファイルで書いてる内容と変わらんのに、妙に内容の評価がよくてﾜﾗﾀ。
やっぱり人は体裁で騙されるもんだなｗｗｗ ・・・それからはパワポに一目置いている俺ｶﾞｲﾙ。
- 263 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 11:27:31 ]
- >>262
発表において、体裁ってもんがどれほど重要か。
どんな小手先の技でもいいから、人の気を引くというのは大切よ。
Word の利点、ぱっと思いついたのだと、
- 修正履歴を残せる → 学生の論文チェックとかかなり楽
- コメントを付けれる → これも校正に凄く便利
- スペルチェック → 英文はとりあえず最初 Word で書いとけみたいな
- 一応、段落ごとにスタイル定義しておいて、スタイルの書式変更したら同じスタイル一斉に変更される
- 264 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 13:27:47 ]
- Wordで20ページ↑の仕様書を書いてみればわかるよ
スタイルとかクロスリファレンスつけておくとマジ便利
目次や索引も自動で作れるし。
これでもう少し図形描画の機能が充実してればなぁ・・・
ま、そっちはVisio使ってるからいいんだけど。
#でも、個人的にはLaTexを吐いてくれるエディタが欲しいところ
- 265 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 13:29:26 ]
- 利点
- 目次作成 + 自動更新
- 図表番号の自動更新
- 266 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 17:20:24 ]
- >>263-265
どれも俺からすると些末な機能なんだけど。
XSLTが大好きな俺的にはXML形式に対応してるところなんかが蝶最高なんだけど、
これはExcelやパワポでもできることだしな。
- 267 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 17:33:54 ]
- Wordの最大のウリは
多数派であるということ
- 268 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 17:50:31 ]
- >>264
最近のはマシなんか？
Wordでページ数多い文書作ると重いわすぐ落ちるわで……
いい印象無かったんだが
- 269 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 18:28:11 ]
- >>264-265
この辺のテンプレート集とかスクリプト集ってある？
折角の利点も簡便で分かり易くないと説得が難しい。
偉いさんてのはプライドを刺激されると意固地になるからな。彼らは難しいとか
理解できないを決して口にせず、それらを必要がないの一言で片付けてしまう。
- 270 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 18:32:51 ]
- >>267
Excelの方が多数派だよ？
総務などの非生産部門には必ずと言っていいほどExcelが導入されてるから
- 271 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 18:33:14 ]
- >>269
目次だのなんだのって、単なるWordの基本機能だから、スクリプトは不要だよ。
ちゃんとスタイル使って（「見出し1」とか「見出し2」とか）文書を
書けば、章番号を自動で振ってくれるし、後でそれをもとに自動で目次が作れる。
- 272 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 18:34:18 ]
- >>270
ExcelとWordでは用途が違うというだけの話だ。
適材適所で使い分けるのが賢いやり方。
- 273 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 18:51:04 ]
- >>271
ありゃ？そうなのか、て言うか基本機能なのかよ！
俺自身が実際に触って、基本機能くらいは理解しないと話にもならんな＿|￣|○|||
それが何とも億劫と言えば億劫なんだが……
俺も偉いさんの事をとやかくは言えんな……
>>272
問題は、決して賢くないという点だ！Σ(´Д｀ ）
- 274 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 19:02:01 ]
- >>273
www.amazon.co.jp/exec/obidos/ASIN/4774117501/
この本がおすすめ。
アウトラインモードで取り敢えず書くのが
自然に思えてきたら結構使ってる人なんじゃないでしょか。
- 275 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 21:47:06 ]
- >>273
俺、元々LaTeX派だったけど、3日でWordに転向しちゃったよ。
割とすぐ覚えれる。
- 276 名前：名無しさん＠そうだ選挙に行こう [2005/09/11(日) 21:50:52 ]
- >>274
この本、自分も人から薦められて買ったけど、かなりいい本ですね。
職場に一冊常備すべし。
- 277 名前：名無しさん＠そうだ選挙に行こう mailto:sage [2005/09/11(日) 22:54:18 ]
- Win板かソフ板の話題が続いている件について
- 278 名前：デフォルトの名無しさん mailto:sage [2005/09/12(月) 00:35:07 ]
- >>274-276
ホントかよ？ジエリじゃねぇだろうなｗ
とりあえず明日本屋行ってくるよ。初心者向けではないみたいだから
一緒に入門書も買ってくる。
- 279 名前：デフォルトの名無しさん mailto:sage [2005/09/12(月) 00:59:59 ]
- >>278
じえんじゃないよ。
まあじえんだとしてもいいじゃん
本屋で立ち読みしてみて決めてちょー。
カラーページがないところとかが硬派で
それだけで好感が持てますだ。
DTPのマナーみたいな話も、システム文書には
必要ないけど、面白かったな。
- 280 名前：デフォルトの名無しさん mailto:sage [2005/09/16(金) 00:55:41 ]
- Wordのスタイル機能は書式をいぢりづらいのがネック。
特にスタイル使わずに書かれた文章にスタイルを導入しようとすると死ねる。
- 281 名前：デフォルトの名無しさん mailto:sage [2005/09/16(金) 10:45:36 ]
- >>280
あとからは相当骨でしょそりゃー。
- 282 名前：デフォルトの名無しさん mailto:sage [2005/09/23(金) 00:26:28 ]
- なんかMSワードって何処でも決まって悪者にされる傾向があるけどなんでだろうね。
俺はかなり良いソフトだと思うんだけど。いやマジで。
今までアドビのフレームメーカーとかロータスのワードプロも触ってきてるけど
ワードのUIはそれらより飛びぬけて直観的だし、機能も多い。
ワード使い難いって奴はフレームメーカー使ってみるといいかも。
フレームメーカーの糞UIはマジで殺したくなるよ。それでいてワードより高かったりしたから恐れ入る。
まあでも時々挙動不審だったりするし、段落番号の設定みたいに異常にわかり難い
UIがあったりする欠点は確かにあるな。
それにしても、ワード貶してる奴らに関しては、ワードの問題というより
そいつらの能力の問題じゃないかと思うが。
- 283 名前：デフォルトの名無しさん mailto:sage [2005/09/23(金) 01:07:59 ]
- デフォルト設定のせい
UNIXが使いにくいのとおなじ
- 284 名前：デフォルトの名無しさん mailto:sage [2005/09/23(金) 11:01:41 ]
- それにしても、UNIX貶してる奴らに関しては、UNIXの問題というより
そいつらの能力の問題じゃないかと思うが。
- 285 名前：デフォルトの名無しさん mailto:sage [2005/09/23(金) 14:04:57 ]
- じゃあWordに文句を言うやつも無能だな。
- 286 名前：デフォルトの名無しさん [2005/10/10(月) 16:31:55 ]
- >>285
そりゃ無能だろ
- 287 名前：デフォルトの名無しさん mailto:sage [2005/10/10(月) 17:27:01 ]
- あーでもWordの使いにくさとUNIXの使いにくさは別だな。
UNIXはどうしようもないからな。
- 288 名前：デフォルトの名無しさん [2005/10/10(月) 17:33:25 ]
- doxygen 1.4.5 age
- 289 名前：デフォルトの名無しさん mailto:sage [2005/10/10(月) 17:34:07 ]
- なんで並列に語ってるのか知らないけど あえてノルなら
Wordの使いにくさは 袋小路 であり、UNIXの使いにくさは 迷路 だ。
Wordでやりたいことをやるとき、正式な方法が無いことはよくあり
正式じゃない方法で突破することが多い
UNIXでやりたいことをやるとき、正式な方法がそもそも難解で
そのことを訴えると「道があるんだからいいだろ」と突っぱねる
- 290 名前：デフォルトの名無しさん mailto:sage [2005/10/10(月) 18:29:51 ]
- Linuxの場合、とっつきやすさや使いやすさを最初から目指していないのだから使いにくくて当然な気がする。
Wordはなー。MSってUIにけっこう力入れてるはずなのになんであんなことになるのか。
- 291 名前：デフォルトの名無しさん mailto:sage [2005/10/10(月) 19:38:35 ]
- 英文だと一般の評判多少マシなのか？
- 292 名前：デフォルトの名無しさん [2005/10/11(火) 11:07:21 ]
- ドキュメンテーションを書くときは常に例を書き込むとかなりグー。
PHPのドキュメンテーションなんていい例じゃないかな。
使い方系のドキュメンテーションはシナリオ書いとく。
ところで、結局Wiki立てても書くのは結局一人だけだよなぁ。
でもみんなで書くという機能よりも手軽にどこからでも書けるというのが気に入ってる。
使いこなすとかなり快適。あとはVISIOでちょっと図を描いて終了。
- 293 名前：デフォルトの名無しさん mailto:sage [2005/10/27(木) 03:40:16 ]
- 確かにリファレンスとかは、
動作例ある方が読みやすいもんな。
つーか動作例無いと、リファレンスに見えないというか。
- 294 名前：デフォルトの名無しさん mailto:sage [2005/11/01(火) 01:47:40 ]
- ドキュメントなんか書いてる暇があったらソースを書け。
- 295 名前：デフォルトの名無しさん [2005/11/06(日) 15:48:48 ]
- 概要仕様はワープロソフトできっちり作るな。納品しやすいし。
細かい仕様はソースにコメント埋めまくり。
ワードとかUNIX使いこなせない香具師はスキル低いだけ。
何か一つだけしか覚えられない香具師がエクセル使っている感が有るな。
自由紙、原稿用紙、レポート用紙、方眼用紙っていろいろあるけど、どれか一つ選べって状態で方眼紙選んじゃってるだけだ。
レポート用紙にグラフも書けるのにさ。
- 296 名前：デフォルトの名無しさん [2005/11/11(金) 16:36:53 ]
- どのソフトを使うかなんか関係ないって。中身ですよ中身。
つーか、こんだけソフト開発が行われてるんだから、もちっとドキュメント作成技術も洗練されていてくると思うんだけどな〜。
どこのプロジェクト行っても、読まれない＆読んでも意味ないドキュメントばっか。
新規で起こす時も役にたたねぇだろうなーと思いつつ作ってるし。
それともオレが知らないだけで、既に良いツールor作成理論とかあったりするの？
もしあったら教えてエロイひと
- 297 名前：デフォルトの名無しさん mailto:sage [2005/11/11(金) 22:53:22 ]
- >>296
コツを教えてあげるよ
自分が欲しいと思えるドキュメントを作ればいいよ
役に立つように作るべし
役に立たないと思った個所はどんどん削除
- 298 名前：デフォルトの名無しさん mailto:sage [2005/11/11(金) 22:55:25 ]
- あと、起承転結では読みづらいので 起結承転 を心がけること
- 299 名前：デフォルトの名無しさん mailto:sage [2005/11/11(金) 23:11:01 ]
- 正直「転」はいらん。
- 300 名前：デフォルトの名無しさん mailto:sage [2005/11/11(金) 23:23:41 ]
- 統合設計書作成アプリケーション作って。
普通のアプリでWikiっぽい機能＋Wordの章番管理＋Excelみたいな表が
自由に作れる幹事で
- 301 名前：デフォルトの名無しさん mailto:sage [2005/11/12(土) 08:19:16 ]
- 転ってアレか。
この関数は○○の機能を持つ <- 起結
ただし、××の副作用を持つ <- 承転
- 302 名前：デフォルトの名無しさん mailto:sage [2005/11/12(土) 17:11:51 ]
- さすがにtxtを推奨する奴はいないようだ。
- 303 名前：296 mailto:sage [2005/11/14(月) 09:43:53 ]
- いや、ドキュメント書けないわけじゃないないけどね。
この業界、結局ウォーターフォール型がほとんどじゃない？
だったら 要求＞仕様＞設計＞試験 ぐらいのテンプレートとか支援ツールあってもいいんじゃねーかなと思って。
それに有名な規格ができたら、顧客の理解度、満足度ももっと高くならないかなぁ。とか
（Rational Rose とかは勘弁な。”UML図”だけじゃレビュー通らないし）
あと変に思うのは設計書。実装イメージをそのまま文書にしたのをよく見かけるけど、設計書は利用者ガイドであるべきだと思うんだ。
あの高いソフト買うと付いてくる大量のマニュアル郡みたいに、コンセプト、概要、実装サンプル、注意点、とか。
設計者が変わりに文書で実装しても意味ないっしょ。
あ〜ぐだぐだと駄文書いてスマヌ
- 304 名前：デフォルトの名無しさん mailto:sage [2005/11/14(月) 10:41:15 ]
- 俺もそう思う。
納品物としての仕様書なんかいらん。読んでくれないし。
きっちり書いたユーザーマニュアル納品すれば一番ブレがない。
要求は全てそこに落とせばいいんじゃないかなあと。
だからマニュアルといっても画面の説明だけじゃなくて
半分業務マニュアルって感じ。
所謂仕様書らしい仕様書は、
お客さんにガッチガチの情シスがあって
そこが出せっていうんだったら書くよ、って感じで
いいんじゃないでしょうか。
なんか仕様書とあまり変わらないか。
でも言葉とかフォーマットとか、もっとお客さんに優しい感じ。
- 305 名前：デフォルトの名無しさん mailto:sage [2005/11/14(月) 13:50:36 ]
- 納品物としての仕様書は、
質重視ではなく量重視だな。
- 306 名前：デフォルトの名無しさん mailto:sage [2005/11/14(月) 15:40:39 ]
- すると普通の仕様書より表現が冗長になりそうな
マニュアルでの納品がやっぱいいな
スクリーンショットわんさかで
- 307 名前：デフォルトの名無しさん mailto:sage [2005/11/14(月) 21:10:06 ]
- >>301
そんな感じ
注意事項
|
 |
