HN 日本語サマリー

← 一覧へ戻る
オープンソース

Book Corners が OpenStreetMap に貢献を同期しない理由

Why Book Corners won't sync contributions back to OpenStreetMap (andreagrandi.it)

125 pointsby pizzaiolo81 コメント

要約

Book Corners は、ユーザーが追加した公共の書架情報を OpenStreetMap (OSM) に貢献する機能を検討しましたが、実装を見送りました。OSMへのデータ寄贈には、詳細な計画の公開、コミュニティとの協議、ライセンスの確認、継続的な運用責任など、小規模プロジェクトにとって過大な負担が伴うことが判明したためです。著者は、技術的な側面だけでなく、組織的・社会的な契約の重要性を強調し、現時点ではこの機能の実装がプロジェクトの目的と釣り合わないと結論づけました。

全文翻訳

Book CornersがOpenStreetMapに貢献を同期しない理由

明らかに良いと思われた機能

Book Cornersを導入した際、その初期データの多くがOpenStreetMapから来ていることを説明しました。OSMは、世界中の何千もの公共のブックシェルフが既にマッピングされており、このプロジェクトに有用な出発点を提供してくれました。

Book Cornersはユーザーから直接新しいライブラリを受け付けることもできます。人々は場所と写真を提供でき、その貢献はモデレーション後に公開されます。もしそれらの投稿のいずれかがOSMに存在しない場合、Book CornersがそれをOSMに貢献できれば、それは公平なことのように思えました。

意図したのは、無制限のバックグラウンド同期プロセスを作成することではありませんでした。私が考えていたワークフローは、意図的に慎重なものでした。

  • ライブラリを投稿する人は、貢献を明示的に許可する。
  • 管理者が最初にライブラリを確認する。
  • Book CornersはOSMで重複の可能性を検索する。
  • 管理者は送信される正確なデータをプレビューする。
  • 管理者が確認するまで何も書き込まれない。

ソフトウェア開発の観点からは、これは管理可能な統合のように見えました。同意の追加、貢献状態の追跡、プレビューの構築、OSMとの認証、そしてAPIを介した新機能の作成です。

コードは難しい部分ではありませんでした。

データ貢献は単なるAPI呼び出しではない

適切に実装を調査し始めると、APIへの書き込みは作業のほんの一部に過ぎないことがわかりました。

情報はBook Cornersのデータベースから来るため、OSMはそれを外部データインポートと見なす可能性があります。ソフトウェアが変更を準備して送信するため、管理者が個々のライブラリを確認するとしても、スクリプト支援または自動編集の規則に該当する可能性もあります。

OSM Import GuidelinesとAutomated Edits code of conductの保守的な解釈に従うには、専用のアカウントとOAuthトークン以上のものが必要でした。

最初の本番貢献の前に、私は以下を行う必要がありました。

  • 専用のOSMインポートアカウントを作成・維持する。
  • OSM Wikiに詳細なインポート計画を公開する。
  • データソース、ライセンス、フィールドマッピング、重複検出、ソフトウェア、品質チェック、変更セットポリシー、ロールバック手順を文書化する。
  • OSMコミュニティフォーラムで提案を公開する。
  • 貢献の影響を受ける関連するローカルコミュニティに連絡する。
  • レビュー期間を経て、懸念事項を解決する。
  • インポートアカウント、計画、議論、変更セット間の永続的なリンクを維持する。
  • 将来の質問や苦情のための連絡先とオプトアウトルートを維持する。

重要なライセンス上の問題もあります。ユーザーがライブラリをOSMに送信する許可は、OSMと互換性のある条件でその事実情報を公開するための十分な明確な権利を持つことと自動的に同じではありません。ユーザー向けの説明と同意は、その区別をカバーし、情報が互換性のないソースからコピーされていないことを確認する必要があります。

これらの要件は、一度完了して忘れるようなものではありません。それらはアカウント、文書化されたプロセス、コミュニティからのフィードバック、失敗、および潜在的なロールバックに関する継続的な責任を生み出します。

これらのルールが存在する理由を理解している

OpenStreetMapは共有されたグローバルデータベースです。不適切なインポートは、数千の重複を作成したり、より良いローカル知識を上書きしたり、他の人々が同じオブジェクトを編集した後に削除が困難なエラーを導入したりする可能性があります。

その観点から、文書化、ライセンスの明確さ、重複処理、責任あるオペレーター、コミュニティでの議論を要求することは合理的です。OSMコミュニティはマップの品質を保護しなければならず、善意だけでは良いデータは保証されません。

Book Corners自体もそのデータ品質の恩恵を受けていました。外部サービスからの変更をセーフガードなしでOSMに受け入れさせることを期待するのは偽善的でしょう。

同時に、そのプロセスには実際のコストがかかります。それは、小規模なプロジェクトに、APIクライアントであるだけでなく、文書化されたインポートプログラムのオペレーターにもなることを要求します。これは大量のデータセットをインポートする組織には適切かもしれませんが、注意深くレビューされた少数の公共のブックシェルフをコミュニティに貢献することだけを目的とした低ボリュームの機能にとっては、かなりのコミットメントです。

運用上の作業が価値を上回る

Book Cornersのシンプルな目的は、人々が小さな無料のライブラリを発見し、新しいものを他の人と共有するのを助けることです。

OSM貢献パイプラインの運用は、その目的に中心的なものではありません。認証情報、本番環境のセーフガード、監査および照合コード、コミュニティプロセス、ライセンス作業、そして長期的なサポート義務が追加されます。個々の部分はそれぞれ正当化できますが、それらが組み合わさると、当初意図していたよりもはるかに大きな機能になります。

機会費用もあります。この統合の運用に費やされた時間は、ライブラリ発見、モデレーション、写真、アクセシビリティ、翻訳、またはモバイルエクスペリエンスの改善に費やされる時間ではありません。これらの改善はBook Cornersのユーザーに直接役立ち、小規模プロジェクトが維持しやすいものです。

貢献し返すことは、単に良い、公正なことだという感情から始めました。それを調査した後、善意だけでは、オープンエンドの運用責任を受け入れる十分な理由にはならないと考えるようになりました。

決定

OSMへの書き戻し実装を無期限に停止することを決定しました。

Book Cornersは、OSMからインポートされたレコードのソースとしてOSMを継続的に認識し、OSMからインポートされたライブラリが新しいものとして再度送信されることはありません。しかし、Book Cornersに直接貢献されたライブラリはBook Cornersに残ります。サービスは、対応するOSMオブジェクトを自動的または手動で作成しません。

現在、Book Cornersから本番OSMへの書き込みは行われていないため、作業を停止しても既存の統合を無効にしたり移行したりする必要はありません。

もし本当に軽量なワークフローが利用可能になった場合、またはBook Cornersの貢献の規模と価値が最終的にプロセスを正当化するようになれば、この決定を再考するかもしれません。別の可能性としては、既存のOSMエディターで提案された機能を_開く_ユーザー主導のワークフローがありますが、それは依然としてルールを回避する方法としてではなく、コミュニティと議論される必要があります。

今のところ、責任ある選択は、適切にサポートできると確信していない機能を構築・運用しないことです。

時には正しい機能は機能がないこと

実装の決定を純粋に技術的なものとして考えるのは簡単です。APIはそれを実行できるか、アプリケーションは認証できるか、コードは重複を回避できるか?

この経験は、外部統合には組織的および社会的な契約も伴うことを思い出させてくれました。時にはそれらの契約はコードよりも高価です。展開前にそれを見つけることは、結果が残念であっても有用です。

共有されたオープンプロジェクトにデータを貢献することは依然として価値があると信じています。また、OSMがデータベースを非常に注意深く保護している理由も理解しています。しかし、Book Cornersにとっては、現在の規模では、利益と責任のバランスが取れていません。

したがって、これは私が提供しないことを選択した機能の1つです。