libgit2 / libgit2/libgit2sharp

The road to 1.0 (or - at least - a stable API)

未關閉
#947 19 則留言 1 個 reaction 已指派 0 人 在 GitHub 檢視

還沒有人認領這個 Issue。

主要語言
C#
星號
3.5k
分支
925
PR 合併指標
30 天內沒有已合併 PR

描述

We've discussed a stable API for some time, and we keep pushing back on a 1.0. I'd like to restart the discussion and try to list some action items on the things that we want to consider a "solid" API that we will guarantee.

Boring rationale:
We've been using LibGit2Sharp in Visual Studio and Team Foundation Server for a few years(!) now, with great success. So much, in fact, that we have about 10 independent groups on the VS and TFS teams using it. And of course we want to ship a single copy of LibGit2Sharp in the VS or TFS installer, so that means that all of these teams have to be on the same version.

This is becoming increasingly burdensome for us, because any time there's an API change, either the person updating LibGit2Sharp has to go and find all the people using it, fix them and hope it works or simply push it on up and put the build on the floor. (Usually the former, as it turns out that breaking the Visual Studio build is not a good career decision.)


/cc @jamill 

貢獻指南

開啟貢獻指南

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

研究方向

尚未確定檔案、測試或進入點。首先閱讀 issue 討論,並盤點公開的 LibGit2Sharp API 以及版本管理方面的考量;當就穩定 API 的要求和可執行的後續事項達成共識時,即視為完成。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
csharp
領域
api
Issue 類型
功能
難度
5/5
預估耗時
一週以上
活躍度
停滯
描述清晰度
需要釐清
新手友好度
25/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。