ゆるふわOSS入門

repo_url

date

Sep 14, 2021

thumbnail_url

slug

yurufuwa-oss

status

Published

まえがき

GitHub が好きで仕事ではもちろん、休日や隙間時間にもよく使っている。あと、結構ライトに OSS (オープンソースソフトウェア)に関わっている。なぜかというと、純粋に楽しくして学びが多いから。OSS と聞くと敷居が高く感じてしまうけど、本当に様々なものがある。自分は比較的ゆるいものにゆるく関わっている。そう、「ゆるふわ OSS 的活動」をしている。あまりイメージつかないと思うので、実際にどんな形で関わっているか、何が得られるか、どんなモチベーションでやっているのかなど紹介していこうと思う。

どんな使い方しているのか

1. ライブラリの探索

とりあえずタイムラインをながめるのが日課となっている。フォローしている人の Star。Watch しているリポジトリの更新などが表示されてくる。これを見ているだけで日々発見があるので楽しい。

2. スターを遠慮なくつける

そこで気になる技術があったらすかさず「スター！」。スターは開発者のモチベーションになるし、積極的にしていく笑。スマホのアプリでも電車とかでみたりして、すかさず Star している。そうすると、いざ使うタイミングになった時に「前なんか良さそうなあったな」とかで思い出すことが多い。絞り込んだりして見つけることができる。そう、自分のためにもなるのである。

Filter や Sort なども自由自在にできる。Star は 1.5k を超えた。

‎GitHub

Good app, but I've found a push notification problem.I use this app in iPhone and iPad Pro, and I had installed this app iPhone first, and iPad Pro is last.There is a notification problem that pull request reviewer's comment notification comes only iPad Pro, and no notifications come into iPhone.Please fix it.

https://apps.apple.com/jp/app/github/id1477376905

3. 実装の参考にする

生きた情報がたくさんあがっている GitHub には大変お世話になっている何か困ったらとりあえず検索窓にいれる。イシューやディスカッションに目を通して解決することもあれば、コードをピンポイントで検索して他の人はどうやって実装しているか参考にすることも多い。検索の仕方は以下ページが参考になる。

コードの検索 - GitHub Docs

GitHub 上のコードを検索することができます。そして、これらのコードを検索する修飾子を組み合わせることで、検索結果を絞ることができます。

https://docs.github.com/ja/github/searching-for-information-on-github/searching-on-github/searching-code

自分なりの PR 送り方

1. 業務で動かなくて困ったら直接PR送る

一時的にはバージョンさげるなどで対応できるが、普通に困るので勢いで出来そうだったら直しちゃうムーブ。中は覗くことあまりないから、普通に面白かったりする。

例：

ESLint の CI 動かなくなったり

https://github.com/reviewdog/action-eslint/pull/58

Vercel の preview url 取得ができなくなったり(Cypress を CI で回す際に使っていた)

https://github.com/patrickedqvist/wait-for-vercel-preview/pull/12

NextAuth.js 触っていたときに型のエラーが出たり

→ これは結局、型ではなくドキュメントの方を更新した
https://github.com/nextauthjs/next-auth/pull/2268

ドキュメントのリンクが切れていたり

https://github.com/netlify/next-on-netlify-demo/pull/8

2. 手元で動かし思ったところがあればPR送る

スターなどしていて、手元で OSS を動かしていると気になることがあったりする。それを、そのままにせず本家にフィードバックするという関わり方だ。

例：

nobelium：Notion + Next.js でいい感じのブログをつくれるOSS

craigary/nobelium

A static blog build on top of Notion and Nextjs, deployed on Vercel. Demo: https://nobelium.vercel.app/ Screenshot 🚀 Fast and responsive Fast page render and responsive design Fast static generation with efficient compiler 🤖 Deploy instantly Deploy on Vercel in minutes Incremental regeneration and no need to redeploy after update the content in notion 🚙 Fully functional Comments, full width page, quick search and tag filter RSS, analytics, web vital...

https://github.com/craigary/nobelium

自分はよく Tab でカーソルを移動させるのだが、タブでリンクがフォーカスされなくてPR送ったのがきっかけだった。そして、触れば触るほど自分にできることや改善できることなどがどんどん見えてくる。その後もいくつかPR送っていたら、作者の方から感謝とともに開発チームに招待してもらった。実はこのブログも nobelium をベースにしているので、自分のためでもある笑。

fix(a11y): tag link & header logo link by yokinist · Pull Request #111 · craigary/nobelium

Thank you for develop awesome blog system 💯 I sent PR for the following reasons: The tag link was implemented with click event on non-interactive content. -> fixed link to use next/router for accessibility (enter tab & on key press...) FYI: https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/master/docs/rules/no-noninteractive-element-interactions.md The style of selected tag was not applied on search page.

https://github.com/craigary/nobelium/pull/111#issue-630731994

業務では触れられないことができるのがとても良い。

実際に学んだこと：

Tailwind CSS について学んだ

SSG / ISR周りの理解が深まった

Notion API について学んだ

日付や言語設定について学んだ

英語でのコミュニケーション？

など...

その後の開発で Tailwind CSS を採用したのだが、この経験があったから踏み切れたところも多い。自分で0からつくると環境をつくりあげるまでで疲れてしまったり、何をつくるかというアイデアがなかなか出ないことも多い。OSSには既に形になっていたり、誰かに使われているといったものも多い。自分のためだけでなく、誰かのためにも繋がるので幸せの世界。