RubyおよびRuby on Rails人気の問題-不十分なドキュメント

私の考えを共有したいと思います。 Ruby、Ruby on Rails、Ruby vs PHP、Python vs PHPに関する多くのトピックを読みました。 「それぞれのシギは沼地を賞賛しています。」 これは純粋に全員の問題だと思います-どのシステムまたはプログラミング言語を使うか、彼らが言うように個人的な好みは、仲間の味と色を探すためです。 しかし、ポイントはそれでもありません。 私はPHPをよく知っていますが、少し前にRubyとRuby on Railsの勉強を始めました。 あなたはこれがどれほど奇妙に聞こえるか知っていますが、私は両方のシステムが好きです-PHPとRubyの両方、おそらく同じです。 Rubyには魅力的な独自の魅力があります-PHPの言語そのものの力、非常に明確で簡潔な構文（実際に研究にアプローチする場合）-シンプルさと言語のすべての簡潔さ。 優れたシステム、優れたツール、それでも追いつく役割のRuby。 ここで何が間違っていますか？



そして、それが私が考えたことです。 Rubyが今、とても魅力的でファッショナブルな開発言語である場合、そのプロモーションには何らかのきしみが伴うのはなぜですか？ すべてが明確で理解できるように見えますが、何かが明らかに欠落しています。 しかし、本質的に最も重要なことはありません-良いドキュメント。 私は多くの異議を予見します。 はい、そうですが、どのような形ですか？ 公式Webサイトには、ドックへのリンクがいくつかあります。 すべてが良いようで、すべてが豊富です。 しかし！ 基本メソッドコア（！）Method_missingの説明が見つからなかったが、別のソースにあるドキュメントを信頼する方法を教えてください-何らかの理由でお願いします！ さらに、関連する同様の方法への相互参照はありません。



そして、これはすべてPHPのドキュメントとどのように異なりますか。 ここにあなたのためのサイトがあります、ここではすべてのドキュメントを見つけることができます-言語、機能、および相互参照の説明。 PHPでどのように書き始めたかを覚えています-サイトを開き、段階的に言語自体を研究し始め、途中で機能について学びました。 ただ素敵！ ゼロから1か月間、私はまったく問題なく小さなサイトを書きました。



Rubyとはまったく異なる状況。 私はRubyの研究にもっと徹底的にアプローチしました-私は本を買って、すべてを徹底的に研究しました（ちなみに、D。フラナガン、松本Y. 原則として、すべてが明確かつ明確に記載されています。 しかし、それを読んだ後、彼らはあなたに何かを簡単に説明したように感じます（「森の端から森の茂みまで」）、そして-「さらに、自分でやろう、兄弟、暗い森を踏みつけ、懐中電灯とコンパス、いいえ、私たちはあなたに与えません-すべてが明確ですぐに理解できます、私たち自身はこの森を静かにさまよい、さまようことなく、あなたは迷子になりません。」 しかし、私が初めてこの「森」にいるということは初めてですか？..



RoRのドキュメントはうんざりします-知らないものを見つけることができません-メソッドの完全でわかりやすい説明はありません。メソッドのパラメーターの説明はありません。例もありません。クラスとそれらの関係の説明もありません。 繰り返しになりますが、異議を回避するために、存在する説明（これはまさに入門書のレベルにあります）は、原則として理解できる説明であると言います。 そして、次はどこに行きますか？ ソースを選択しますか？ しかし、申し訳ありませんが、私はAvtoVAZのサポーターではありません。たとえば、まさにこれらのマシンは購入後すぐに「完成」しなければならないからです。 同様の状況があります-車を普通に運転するために勉強することです。 そして、それは何のためですか？ 車を買うのは、自動車整備士ではなく運転手になりたいからです。 このツールを使用したいのですが、詳細を知りたくはありません。また、指示なしで-再び、ドキュメントの欠如。 多くの人は、自分の携帯電話がどのように機能するかを知りませんが、それをうまく使っています。 興味があるでしょう-私はソースに入りますが、今のところ、これは私にはまったく役に立たないです。 ソースごとに公式Webサイトで同じPHPの機能を研究することを提案したかどうか覚えていません。 私はプログラミング言語、フレームワークを使用し、教科書で提示されたレベルだけでなく、ソースを停滞させずに開発および前進するために、最大限に活用したいと考えています。 正しく理解し、使用するツールの詳細については気にせず、すべての機能を正しく実行し、これらのすべての機能について知りたい場合は、ドキュメントから「ツールの使用方法」を知り、誰にも尋ねない検索してインターネットをクロールしないでください。



私自身の経験から見る限り（私はIT業界に20年以上在籍しています）、便利で手頃な価格のシステムが勝つことが多く、優れた便利なドキュメントを持つことは成功のほぼ半分であり、すべてが内部でクールなシステムではなく、外部の観察者にとっては成功です明確ではなく、誰にも言えません。



ここで、実際、私の考え。 PHP、Ruby、Python、C ++、Java-マシンと通信する唯一の方法であり、それ以上のことはありません。 そして、何を書くか、どのように書くかを選択できるという点で、私たちは皆幸運です。 しかし、システムはユーザーやプログラマーが簡単に学習できるようにアクセスしにくいままですが、ドキュメントがないことで隠れているクールさの代価は価値がありません。 例に目を向ける必要はありません。開発ツールの人気と普及は、その入手可能性と、特に便利で完全なドキュメントの入手可能性の結果にすぎません。



フォーラムやその他のさまざまな情報源の存在については、文書化を考慮していないことを直ちに予約してください。 強力なシステムには、まず、完全で便利なドキュメントが必要です。 そして、私は、ビジネスをする代わりにソースコードを研究するあなたの貴重な時間を費やすことは、最も楽しくて役に立つ練習ではないということで、多くの人が同意するだろうと思います。 ソースコードを知っているのは確かに良いことです。そのようなすべてを開発しますが、やるべきことはたくさんあります。RubyとRuby on Railsの開発者が優れたドキュメントについて考える時です。