ドキュメントを超えて新しいライブラリを学ぶ方法

ドキュメントを超えてライブラリや機能の実際の使用法を確認したい場合は、GitHubのコード検索を使用してください。

たとえば、条件付きGETサポートに関するRailsガイドを読んだとします。理解できた気がしますが、実際に使う前にもう少し例を見てみたいです。

GitHub検索にアクセスして、"if stale?"を探すことができます。 。次に、サイドバーでcodeを選択します およびRuby ：

{％img img-response /images/posts/code-search.gif783484コードを検索しています。 ％}

そして今、私はstale? 使用できます。

すべての例が興味深いわけではありません。しかし、あるリストでは、著者がPost.maximumを使用していることに気づきました。 ：

class ArchivesController < ApplicationController
  def index
    if stale?(last_modified: (Post.maximum(:updated_at) || EPOCH).utc, public: true)
      @months = Post.find_all_grouped_by_month
    end
  end
end

これは、stale?を使用するのに最適な方法のようです。 。そして、この例を見ていなかったら、試してみようとは思わなかったかもしれません。

見つけたものをどのように使用する必要がありますか？

オープンソースコードを検索すると、ほぼすべての機能の例が何百も表示されます。 ドキュメントが意味をなすところと、それが過度に単純化されているところに気付くでしょう。そして、オブジェクトが実際のコードで一緒に機能しているのがわかります。これにより、どのRDocよりもクラスがどのように接続されているかがわかります。

それでも、例を使用して新しいことを学び、自分のプロジェクトにカルトを詰め込むのではありません。 理解せずにコードを使用することは、システムの設計が不十分な場合の最速の方法です。

私の例では、maximum 私のプロジェクトでは正しくないかもしれません。私はそれについてもっと学ぶことなしにその行をコピーするべきではありません。いつ使用するのが理にかなっているのか理解せずに。しかし、例はあなたが前に知らなかったことをあなたに教えることができます。そして、それらは次に何を学ぶべきかを決めるための素晴らしい方法です。

他の検索と同様に、良い結果を得るにはある程度の練習が必要です。しかし、私は見つけたコードから多くのことを学びました。あなたもそうなることを知っています。