github化に伴う編集ルールの再検討

[usagi]

#13 から派生して、「そもそものgithub化に伴う編集ルールの再検討をしておきましょう！」と言う事で別にIssueを発行しました。以下、 #13 から派生した主要な流れ。

@melpon
ひとまず、作業状況を削除して、wiki にも同様のページを作っておきました。

https://github.com/cpprefjp/site/blob/master/reference.md
https://github.com/cpprefjp/site/wiki/progress

（ほんとはこういうのはチケットで管理した方がいいんでしょうけど…）

@usagi
少なくともcpprefjpにページとしてあるよりは見やすく編集しやすくなったので良いと思います。チケット化についてはgithub管理化以降の計画的な取り組みについてはgithubのIssuesを使う方針にできれば良いかと思います。

typo修正やそれほど大きくない程度であればpull-reqと編集者からのレビュー（何件以上とか条件付けるかは必要なら別スレッドで議論するにしても）でmergeが良い様にも思えます。現状では事実上レビューなしで参加者なら誰でも編集、pull-reqも権限のあるメンバーが気付き次第、明らかな問題点が見当たらなければmergeしている状況ですが、githubを使って居る事でpull-reqやレビューはとてもやりやすい状態になっており、いわゆるgithub-flowの採用は参加者への負担もさほどなくcpprefjpの品質を維持しつつ多くの参加者（直接編集権の有無に関わらず）が安心して編集に参加できる良いルールとなると私は思います。

本チケットでは、「github化に伴う編集ルールの再検討」について議論する事を目的とします。

草案として @usagi からは「以降は github-flow を採用して編集を進めてはどうか」と提案致します。みなさまご意見よろしくお願いいたします。

[faithandbrave]

このチケットで何をすればいいかわからないです。何を再検討すればいいのでしょうか。このチケットはどうすれば閉じれるのでしょうか。

#13 での melpon の以下の発言は、

（ほんとはこういうのはチケットで管理した方がいいんでしょうけど…）

#13 のチケットが、一つのチケットで複数の問題が提起されたため、一つの問題を解決してもそのチケットを閉じれない、ということを言ってるのだと思います。

[usagi]

丁寧に書いたつもりでしたが伝わらない様で残念です。伝わらない事に意味はありませんから閉じます。

[melpon]

#13 のチケットが、一つのチケットで複数の問題が提起されたため、一つの問題を解決してもそのチケットを閉じれない、ということを言ってるのだと思います。

ああいえ、そうではなくて、リファレンスの進捗自体をチケット管理した方がいいなーという話です。
要するに progress のページを亡き者にしたいということです。

今だと、ヘッダ単位だから粒度が粗すぎるのと、本当は誰がどのページをやってるのか見えにくいのと、進捗ページの更新をちゃんと実際やってる人と同期させるのも難しいなーと。

『このヘッダのこのクラスのリファレンスを書く』とかをバーっとチケットにしておいて、「まだ誰もやってないクラスあるかなー」とか、「このクラスのリファレンス、時間が掛かってるので手伝う（or 奪う）かな」とか、「この人ちょっと同時にやりすぎだから実際に作業してないリファレンスをフリーにしてもらおう」とか、そういうことができていいかなーと思った次第です。

この Issues でやってもいいのですが、バグとタスクがゴッチャになるのもなーとか思ったり…。

[faithandbrave]

趣旨は理解しました。しかし、話の流れで混乱しそうなので、これについて議論を続ける場合は、話を整理して別チケットを立ててもらえると助かります。