C# と VB.NET の質問掲示板

ASP.NET、C++/CLI、Java 何でもどうぞ

C# と VB.NET の入門サイト

Re[3]: document生成

分類:[.NET 全般]　

こんにちわ。

最近ちょっと調べていて気づいたんですが、NDoc2.0が終了しちゃったんですね。
期待していたのに残念です。
そこで聞きたいのですが、皆さんはドキュメント生成にどのツールを使っているでしょう？
HotDocumentが使えればいいのですが、なにせ有料でしかも結構な値段もしますし・・・
1万ぐらいなら個人的な趣味PGとしても出そうと思うんですが、あの値段だと会社で使うとかでないとどうにも。

.NET関連、つまりvisualstudioで使えるようなので何かいいのがないかなあと。
NDoc2.0が終了したのはMS謹製の新しいやつのせい？らしいですが、それもまだCTP版で機能的にも使い勝手もまだまだのようですし。

見た目的にもスペック的にも自分の要求を満たすのはHotDocumentなんですが、値段が・・・
あくまでVisualStudioで開発している場合のツールでお願いします。
Javaとかもじゃなくて。

Mr.Tです、こんにちは。

#最初から話がずれてしまうので申し訳ないです。
こういう話はちょくちょくでるんですが、NDocやHotDocumentみたいなドキュメント生成から
だされたものって何をしたくて出す資料なのか、未だによくわかってません。

発注元が必要だから、依頼元が必要だから、というのはNet上でもよく聞く話
なんですが、そもそも、それで出した資料って後から「何に」使える（使う）ものですか？
#個人的にはいらねーじゃん、紙の無駄、と思ってます

■No10942 (ダーシュさん) に返信
> こんにちわ。
>
> 最近ちょっと調べていて気づいたんですが、NDoc2.0が終了しちゃったんですね。
> 期待していたのに残念です。
> そこで聞きたいのですが、皆さんはドキュメント生成にどのツールを使っているでしょう？
> HotDocumentが使えればいいのですが、なにせ有料でしかも結構な値段もしますし・・・
> 1万ぐらいなら個人的な趣味PGとしても出そうと思うんですが、あの値段だと会社で使うとかでないとどうにも。

javadocって何のために必要なんでしょう？
紙の無駄でしょう。

っていう人はいないと思いますが。
無論いつでも必要なものではありませんが。

HotDocumentなんかは納品物として要求されるお客様向けな気がします。
そして要求が契約に入っていれば出すしかありせん。
要らないでしょ？って最初に言って通じたらいいですが、
まあその辺は事情があることも多いでしょう。

ああ、紙で出されたものは実質的には無駄だなあとは、私も思います。

> こういう話はちょくちょくでるんですが、NDocやHotDocumentみたいなドキュメント生成から
> だされたものって何をしたくて出す資料なのか、未だによくわかってません。
>
> 発注元が必要だから、依頼元が必要だから、というのはNet上でもよく聞く話
> なんですが、そもそも、それで出した資料って後から「何に」使える（使う）ものですか？
> #個人的にはいらねーじゃん、紙の無駄、と思ってます

ライブラリ納品の場合があるんで、.chm を納品物に含めることはよくあります＞自分

> javadocって何のために必要なんでしょう？

詳細設計書を書かないで済む場合、XML コメントを特にしっかりと記入するようにしてます。

メソッドはもちろん、クラスや列挙子の宣言にも XML コメントを書くので、ＶＳでクラス図を表示させれば、それだけで十分メンテできることがほとんどです。

> ライブラリ納品の場合があるんで、.chm を納品物に含めることはよくあります＞自分
ああ、これならわかります。
これがないと、いちいち仕様書等で確認しなくちゃならないですもんね。

ただシステム納品物のひとつとして、HotDocument等が必須になる理由がやっぱり
わからないです。
政治的、歴史的流れから？

C# と VB.NET の質問掲示板

ASP.NET、C++/CLI、Java 何でもどうぞ

C# と VB.NET の入門サイト

Re[3]: document生成

過去ログには書き込み不可