No day younger than today

RubyとかRailsとか蒙古タンメンとか

技術書の読み方と向き合う

現在フィヨルドブートキャンプでプログラミングを学習しています。

bootcamp.fjord.jp

学習の中で技術書を読む機会がそれなりにあるわけなのですが、受講生から「技術書の読み進め方がわからない」という話が定期的に上がります。
確かに僕自身も、技術書の読み方の正解がわからないですし、読んでも全てを理解できてはいません。

とはいえ読むからには何か1つでも得たいですし、今後も技術書を読む機会は多くあるでしょう。

今後のためにも今現在の技術書の向き合い方を言語化して、より意識を持って読書できるようにしたいと思い、この記事を書きます。

  • はじめに
  • この記事の目的
  • 自分なりの読み方
    • アウトプット前提で読む
    • 理解できない場所は飛ばす
    • 読書管理サービスを使う
    • Twitterに読書感想文を載せる
  • おわりに
続きを読む

Kyoto.rbのるりま読書会に参加しました

はじめに

2021年7月11日に開催されたKyoto.rbに参加させていただきました。 「るりま読書会」という題目での開催で、るりまはどうしても苦手意識があったので、それを払拭したいというのと、「他の方はどのように読んでいるのか」というところも知りたかったので、参加しました。

たくさんの学びがあったので、メモとして残しておきたいと思います。

会の流れ

るりまとは

るりまとは、Ruby リファレンスマニュアルの略で、Rubyの公式ドキュメント的な立ち位置にあるものです。
Rubyを書く人は間違いなく見ているドキュメントです。

前半

るりまが何を目的としてメンテナンスされているかから始まり、るりまの全体像や読み方の大枠、みなさんがどのようにるりまを読んでらっしゃるかの意見交換をしました。

後半

Enumerableを運営の方主導で読み進めていただきました。
どんな風にるりまを読み進めているのかをリアルタイムで体感できて、自分でも読むときの参考にしたいと思いました。 各メソッドの説明もしてくださり、とてもわかりやすかったです!

Rubyリファレンスマニュアル(るりま)のTips

るりまの説明を聞いている中で、いくつも発見があったので箇条書きで書いていきます。

みなさんの読み方

今回参加された方たちは、「他の人がどうやってるりまを読んでいるか知りたい」という方が多かったようです。
読み方についてたくさんの意見があったので、ピックアップして書いていきます。

  • とりあえずEnumerableをながめて良いメソッドがないか探してみる
    • 定期的に読み返して頭のインデックスを更新する
  • 上から順番に眺めて、気になったメソッドをirbで実行してみる
    • サンプルコードが必ず動くようになっているので、とりあえずコピペして動かしてみるのもアリ
    • 1行ずつコピペしなくても、右上の[copy]ボタンで全コピーしてもちゃんと動くように書かれている(すごい!)
  • 気になるメソッドをピンポイントで調べる
  • 業務上必要になったら立ち返ってみる
    • メソッドの存在だけ知っていれば良い
    • 必要になったときに、見直してみる
    • ユースケースがわからないと覚えづらいから

とても参考になったので、今後の学習に取り入れていきたいです。

雑感

長くRubyを触ってる方でもるりまを見て初めて知ることもあるということを知り、だからこそ定期的に読み直す価値があるのだなと思いました。
僕はまだるりまを通しで読んだことはないのですが、通して読んだり、よう使うクラスやライブラリについては定期的に読み直したりしていきたいです。

また、PRの敷居も低くなっている印象を受けたので、気づいたときには積極的にPRを送ってみたいと思いました。

謝辞

このような会を開催してくださったKyoto.rbの運営の皆様、ありがとうございます。

参考リンク

Kyoto.rb | Doorkeeper

オブジェクト指向スクリプト言語 Ruby リファレンスマニュアル (Ruby 3.0.0 リファレンスマニュアル)

rurema/doctree: Repository of Japanese Ruby reference manual

Rubyリファレンスマニュアルを修正する方法 - 緑の扉

自作のパッケージをnpmに公開した

こんにちは!!
フィヨルドブートキャンプでWebエンジニアを目指してプログラミング習得に励んでいる@ふーがです。

bootcamp.fjord.jp

この度、「cheapest-books」というパッケージをnpmに公開しました。
書籍のISBNをもとに、販売サイト上の価格情報を取得してターミナルに表示するものです。

www.npmjs.com

npmへの公開手順については、別の記事でまとめました。

fuga-ch85.hatenablog.com

なぜこのようなパッケージを作ったのかや難しかった点、今後の課題なども含めて記録を残しておきます。

  • どういう時に使うのか
  • なぜ作ったのか
  • 使い方
    • ✅ インストール
    • ✅ 実行する
  • 実装で難しかったところ
  • 実装でこだわったところ
    • ✅ 書籍タイトルがすぐ表示されるようにした
    • ✅ URLを表示してすぐアクセスできるようにした
    • ✅ 取り扱いがないサイトはその旨表示するようにした
  • 雑感
  • 今後の課題
    • ✅ 対応販売サイトを増やす
    • ✅ ポイント値引きに対応する
    • ✅ 書籍名での検索に対応する
    • Kindle版と単行本版をそれぞれ取得する
    • ✅ 名前をイケてる感じにしたい
  • まとめ
続きを読む

npmへのパッケージ公開方法

こんにちは!!
フィヨルドブートキャンプでWebエンジニアを目指してプログラミング習得に励んでいる@ふーがです。

bootcamp.fjord.jp

パッケージをnpmに公開する手順でしどろもどろしてしまったので、未来の自分が困らないようにメモを残しておきます。

  • npm Sign Upで登録する
  • package.jsonを編集する
  • READMEを作る
  • 公開する
  • インストールして使ってみる
  • まとめ
続きを読む