JSer.infoに紹介してもらいたい記事のPull Requestが出来るようになりました

JSer.info Pull Request Form というサイトを作りました。

どういうサイトかという説明の前に簡単なJSer.infoの運用の話。

JSer.infoに記事が乗るまでの流れ

JSer.infoは大体週1の更新ですが、紹介記事の収集自体は常に行われていて、その収集した記事は半分リアルタイムでjser/jser.infoのリポジトリに追加されて行くようになっています。

週1の更新では、jser/jser.infoのリポジトリにためた記事をJSer.infoのアーカイブから選んで紹介するようになってます。(JSer.infoのアーカイブに入ったものは殆ど紹介するので実質リポジトリに入った段階で確定ですが)

そのため、jser/jser.infoに対して紹介記事のPull Requestをすれば、自分以外でも記事を追加することが可能となっています。

関連issue

仕組み的にはPull Requestすることは可能でしたが、記事データはJSONで管理していて(HTMLもありますがそちらは旧式)追加のフォーマット等が分かりにくいのでPull Reqeustが難しい形でした。

pull requestのガイドラインを作る · Issue #12 · jser/jser.info のissueで、それをもう少しまともにするために、 JSer.info Pull Request Form というサイトを作りました。

このサイトは、フォームにしたがってサイトの紹介を入力すれば、記事データのJSON文字列を作ってくれるサイトです。

JSer.infoでどんな感じで描画されるのかを見られるプレビュー機能も適当についています。

Pull Requestまでの簡単な流れとしては

という感じなっていて、今のGithubはログインしていればオンラインで編集してPull Requestすることが可能になってるので、全てブラウザで完結します。

これで、少しはPull RequestしやすくなったのであなたもPull Requestし放題です！

紹介のポリシーは以下に簡単に書かれているので参照して下さい。文体とかそういうのはPull Request後でも修正できると思うので、どういう説明にするかに集中するといいです。

マージするかは個人的な判断なので保証しませんが、 JSer.infoでまだ紹介してなくて、ブックマークに入ってなくて、面白そうならマージされるんじゃないかと思います。

(マージしない ≒ 拒否ではないので、深くは気にしないといいと思います)

追記:

ブックマークレットが使えるようになりました
- ブックマークレットから項目を埋める by azu · Pull Request #1 · jser/jser.info-tribute
- Parameter に URLのパラメータにあると自動的に入る入力項目の対応が書かれています。
Pull Requestガイドにより詳細な入力項目について書きました。
- タイトルに入れるものや説明の書き方などについて書かれています。