Open Collectiveの経費精算のルールを決める

[azu]

JavaScript Primer - Open Collectiveの予算はおそらくありそう。
実際にContributorが経費精算(お金を受け取る)時のルールを決める必要がある。

目的

• Contributorに対して、Open Collectiveの予算から支払うときのルールを決める
• 経費精算のフローをドキュメント化する

決めること

• 何に対して経費が発生するのか
• 何を基準に金額を決めるか
  • Issue単位?
  • 分量単位?
• どう申請するのか

できるだけシンプルでわかりやすいルールにしないと管理が難しそう。
他のオープンソースなどがどうやっているのかを調べる必要がある。

cc @lacolaco

[azu]

計算方法はこんな感じでどうだろう?
Open Collectiveへの申請にも根拠がいるので、計算しやすいものを書いてみた

タスクに対するPoint

作業量に対する基準としてフィボナッチ数列のPointsを設定する

Points	Description
1	2 よりは簡単
2	大体1日分やると終わる想定
3	2 よりは難しい
5	かなり難しい
8	難易度がとても高いので、できる人は限られる

Issueが適切に分割されていれば、5や8はほとんど出てこないはず。
5以降はブレが大きいので、個別でコストを判断するぐらいのイメージ。

📝 元ネタはLinearのEstimates – Linear Docs

Pointsの例

Pointはやや主観的になってしまうが、基準となるような例を元に判断する。

• Point 1:
  • fix(nodecli): update to marked@14 by azu · Pull Request #1760 · asciidwango/js-primer
    • ほとんど置換で終わるような変更
  • fix: Node.js v18.12.0 LTSにアップデート by azu · Pull Request #1496 · asciidwango/js-primer
    • やり方がだいたい定型化されてる変更
• Point 2:
  • feat(ecmascript): Stage 2.7を追加 by azu · Pull Request #1743 · asciidwango/js-primer
    • 文章自体はほとんどないが、多少調べる必要がある
  • mocha をnode:testに変更する by windchime-yk · Pull Request #1737 · asciidwango/js-primer
    • 1 つのセクションを書き直すような変更
  • feat(map-and-set): Map.groupBy静的メソッドの追加 by azu · Pull Request #1751 · asciidwango/js-primer
    • 1 つのセクションを追加する変更
  • feat: ErrorCause への対応 by himanoa · Pull Request #1732 · asciidwango/js-primer
    • 1 つのセクションを追加する変更
• Point 3:
  • feat(array): Change Array by copy の対応 by azu · Pull Request #1679 · asciidwango/js-primer
    • 複数のセクションにまたがる変更
• Point 5:
  • fix(nodecli): commander パッケージ を node:util の parseArg に変更 by azu · Pull Request #1757 · asciidwango/js-primer
    • 章全体にまたがる変更
    • かなり影響範囲が広く、書き直しも多い変更

金額の計算方法

jsprimerの年間更新コストは、だいたい30日分の作業量になるように設定。

• JavaScript Primer 改訂2版をリリースしました！/JavaScript Primerはなぜ更新され続けるのか？ | Web Scratch

Pointに直すと、年間の作業量のPointは60 Points程度になる。

年間の予算はOpen Collectiveの推定年間予算を参照する

• JavaScript Primer - Open Collective

Note

2024-08-25だと $2,367 が年間の予算

1 Pointあたりの金額は以下のように計算する。

const yearlyEstimatedBudget = 2_367; // Open Collectiveの推定年間予算($ドル)
const yearlyWorkloadPoints = 60; // 1年間のPoints
const onePointCost = yearlyEstimatedBudget / yearlyWorkloadPoints;
console.log({onePointCost}); // => $39.45

const costOfPoint = 2; /// 2 Points
const cost = onePointCost * costOfPoint;
console.log({cost}); // => $78.9

金額を申請するタイミング

作業が終わったタイミングで計算して、そのコストを申請する。