OSS Gateに参加したらOSSにコントリビュートできた

OSSにいつかコントリビュートしたいという想いから、OSS Gate東京ワークショップ2019-09-14に参加しました。

OSS Gateは、OSS開発未経験者の方とOSSの門をくぐった先輩メンターがペアになってOSS開発を体験するイベントです。メンターのサポーターがいるなど育てるが意識されたコミュニティであると感じました。

タイムスケジュールは、以下の通りです。

アイスブレイク
OSS開発手順を説明
対象OSSを動かす
ミニふりかえり
プロジェクトにフィードバックする
ふりかえり
まとめ
アンケート記入
ワークショップのふりかえり

当日の資料は、OSS Gate's slidesにあります。

アイスブレイク

このタイミングで、メンターの方が決まりました。メンターは、@coe401_さんでした。Railsのソースコードを読むのが楽しいという話をされて興味が湧きました。

OSS開発手順を説明

OSSとは何かを教えてもらいました。Open Source Initiativeに記載されているものがOSSということを知りました。Apache License 2.0とMIT licenseの他にも多くのライセンスがあり驚きました。

また、Pull Request(以降、PRと呼ぶ)のみがOSS活動と思っていたのですがIssueを上げることも活動に含まれると知り、少し気が楽になりました。

OSSを選ぶ

対象OSSを決めるところから行いました。以前、簡易HTTPサーバーを作った際に、HTTPレスポンスにおけるContent-Lengthの厳密性がChromeとFirefoxでは異なるため挙動が違うという問題に遭遇しました。そこで、FirefoxとChromeの実装をのぞいてみようと思ったのですがChromeがOSSでないということで断念しました。

そこで、acts_as_tenantまたはgraphql-rubyにしようと思いました。エンジニアとして働き始めて初めて携わったことがGraphQLでAPIを構築することであったこともあり、思入れがあるgraphql-rubyを選定しました。

OSSを動かす

開発の流れは、GitHubリポジトリに記載されています。

Getting Startedを動かす中で、詰まったポイントのフィードバックがOSS貢献につながるということなので、手順通り動かしました。

すると、GraphQL generatorsのOptions項目に--no-graphiql will exclude graphiql-rails from the setupと記述されているが、下記のようにrails g graphql:install --helpで見つからないという問題がありました。

$ rails g graphql:install --help
Running via Spring preloader in process 62782
Usage:
  rails generate graphql:install [options]

Options:
  ...
Skip .keep files for source control
  [--skip-graphiql], [--no-skip-graphiql]                      # Skip graphiql-rails installation
  ...

また、rails g graphql:objectを実行するとテンプレートエンジンに基づいたファイルが生成されるのですが、生成されるファイルとドキュメントに齟齬があることがわかりました。

イベント内で達成できそうなものは、後者だったのでドキュメントを改善することにしました。