alex / alex/pyvcs

Consider replacing "commit" with "changeset" & reserve "commit" for the action

未關閉
#5 1 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視
主要語言
Python
星號
128
分支
11
PR 合併指標
30 天內沒有已合併 PR

描述

I realize you get to paint the bikeshed as you built it, but at least give this some consideration.

It appears you are currently using git terminology. Now obviously you have to use something, but as was recently pointed out [1](http://groups.google.com/group/git-python/browse_thread/thread/a40163e6801d75ef?hl=en#) by someone new to git (on the gitpython mailing list): "commit" is an action, yet the "commit" method refers to a previous commit object. Perhaps "changeset" (as used by Mercurial and others) would be a better term so that "commit" can be reserved for the action of creating a new commit if that feature is ever added to pyvcs.

Now, I realize pyvcs is described as "lightweight", so creating comits may be beyond its scope, but with multiple backends supported by default, there shouldn't be any reason to be married to the terminology of any one specific backend. Rather, the terminology used should be clear to anyone familiar to any one of the supported backends.

貢獻指南

這個儲存庫沒有索引到貢獻指南

評估

這個 Issue 還沒有評估資料。

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

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