オープンソース(OSS)「オープンソースはドキュメントがなくて使いづらい」まあ、ドキュメントないと使いづらいのは事実でしょう。「オープンソースはドキュメントがないから使い物にならない」その意見には賛成できないな。して、そのお金でドキュメントを整備して提供する...オープンソースはそれをやめてソースコードを公開し、(大抵は)お金は取らないことを選んでいるわけです。気軽にユーザーに機能を提供するために。ソースコードを読めばわかるかもしれない。コミッタやメーリングリストに聞けばわかるかもしれない。有償のものはそれが気軽にできないことが多いわけで。流言飛語と言わざるを得ません。「そんな行動をしなきゃいけないのか?」と思うのであれば、オープンソースを使うのを止めて、お金でドキュメント(があるツール)を買えばいい。求めているものが違うだけだから。オープンソースに寄付だってできる。ドキュメント少なOSS「このツール、ドキュメントが少なくて使いづらい」まあ、ドキュメントないと使いづらいのは事実でしょう。「このツール、ドキュメントが少ないから使い物にならない」その意見には賛成できないな。ソースコードを読めばわかるかもしれない。作者やメーリングリストに聞けばわかるかもしれない。流言飛語と言わざるを得ません。したら...ソースコードを読むことで、もっと良い機能が見つかるかもしれないし、コミッタやメーリングリストに聞けば、あっさり問題解決するかもしれない。コードは読みやすければ細かいところも発見しやすい。使いやすいかもしれない。一概にドキュメントだけで、オープンソースの比較はできない。誰がお金を払っているのだろう?ほとんどのOSSでは、お金をもらっていないでしょう。OSSのドキュメントを完全完璧に作るとなると、その作者の人生のすべてを失うでしょう。現実的ではなく誰もツール作りを提供しなくなります。少量のドキュメントとソースコードと属人性のハイブリッドでユーザーに使い方を伝えることで、やっと無料で提供することができるわけです。少なくとも個人やコミュニティレベルでやっているオープンソースはそうと言えるでしょう。(ただし、その分コードは綺麗に書かないと!)その少量のドキュメントの質は確かに重要です。ユーザーの時間にも限りがありますから、いかに入り(はいり)がわかるドキュメントを書くかは、コミッタの永遠の努めでしょう。仮にドキュメントが一切なくても文句は言えません。ソースコードがあって自由に使えるだけでありがたいもので、ドキュメントがあったら「ラッキー」的な感じです。実際に、一切ないツールを使うことはよくあることです。自分でドキュメントも書けるわけです。プルリクだって送れる。自分で作ってみればいい。多くのオープンソースは互助的な精神で成り立っている。フリーライダーの割合が多ければ多いほど退廃していく。それができないのであれば、静かに使わなければいいだけ。業務のプログラムでも共通ライブラリのクラスを作ったり。自分たちの中のクラスだからコードは自由に読める。ドキュメントがないと使い方がわからない?そこにコードもあるよ。入りがわかるドキュメントは欲しい。あと間違いを防ぐためのドキュメントは欲しい。作者はそれ意識してドキュメント作って欲しい。丁寧なドキュメントを求めれば求めるほど、お金かかるよ。会社がその勤務時間を払う。オープンソースの話と似ていると思っています。(大抵)作者も近くにいて聞けるしコードも読める、つまりハイブリッドができるわけで。(ただし、その分コードは綺麗に書かないと!)聞けばいい読めばいい。営利団体である会社としては正しい判断になる。「コストのかかるディベロッパー」と言わざるを得ない。...ただ、コードを読めばってのは程度の話です。コードまでは、さすがに読んだことはありません。情報収集をしてうまく乗り切っています。あれば、IDE上でフレームワークのソースコードを簡単に辿れます。言語で読むことができます。知りたいことは奥底まで読む必要はありません。クリックして辿ればわかったりします。それをやるかどうかが分かれ道だとも言えます。完全完璧に読もうと言っているわけじゃない。ほんのちょっとでも全然違う。伝えていこうとjfluteも、もちろんドキュメントあれこれ言うことはあります。ドキュメントあった方がもっと良いのは事実だし、ドキュメントないと使いづらいってのも事実だし、ドキュメントを書いて差別化しようって事実だし。お金を一銭も払ってないプロダクトに対して、ダメダメ言うことは少なくとも今は恥ずかしく思います。気が引けるイメージはずっと抱えていたように思えます。最近「もういいや」みたいな感じになってきて(^^、しっかりと伝えていこうと思いました。jfluteもディベロッパーだもん。良い判断をするディベロッパーと一緒に仕事がしたいから。いうディベロッパーに育ってほしいから。...ちなみに、DBFluteはドキュメント豊富と褒められることが多いです。最近、わりと追いついてないけど...あと、逆にあり過ぎてわからないみたいな...><一時期、完全完璧を目指してものすごい頑張っていました。完全完璧なドキュメント作るのは無理だと。このままでは人生が完全に壊れる。自分もオープンソースを少し勘違いしてたなと。オープンソースって意識していかないと。書いたエントリかもしれませんね。永遠のテーマかもしれません。再開したディズニーシーにはてなブログをはじめよう!jfluteさんは、はてなブログを使っています。ブログを報告するスターをつけました引用をストックしましたストック一覧を見る閉じる引用するにはまずログインしてくださいログイン閉じる引用をストックできませんでした。再度お試しください閉じる限定公開記事のため引用できません。