在对 github 上的开源项目的拉取请求中,维护者应如何注明原作者?
In a pull request to an open source project on githhub, how should the maintainer credit the original author?
我最近向我也经常贡献的开源存储库发出了拉取请求(我也是维护者),我收到了另一位维护者的请求,要求删除我自己的所有信用,因为这是一个开源项目。
我目前通过在文件顶部使用评论来表扬自己:
#Created by Harsha Goli
我看到这种语法随处可见,所以我对 'proper standards' 是什么感到困惑。其他维护者的评论是:
Removed Author title, this is an opensource project, authored by the community
从道德上讲,您如何评价作者?还是只是以产品为基础?
在评论中留下您的名字并不是获得荣誉的好方法,因为其他人稍后可以更改文件,他们也应该获得荣誉。让我们看看其他项目如何给予作者信用。
我们以Rails为例
作者本人在提交中记入:https://github.com/rails/rails/commit/d57356bd5ad0d64ed3fb530d722f32107ea60cdf
作者在更新日志中注明:https://github.com/rails/rails/blob/master/activejob/CHANGELOG.md
作者在贡献页面中注明:https://github.com/rails/rails/graphs/contributors
其他一些项目有一个包含贡献者列表的文件:https://github.com/RubyMoney/money-rails/blob/master/CONTRIBUTORS
我个人认为让我自己作为提交作者已经足够了。更新日志也很好。
我最近向我也经常贡献的开源存储库发出了拉取请求(我也是维护者),我收到了另一位维护者的请求,要求删除我自己的所有信用,因为这是一个开源项目。
我目前通过在文件顶部使用评论来表扬自己:
#Created by Harsha Goli
我看到这种语法随处可见,所以我对 'proper standards' 是什么感到困惑。其他维护者的评论是:
Removed Author title, this is an opensource project, authored by the community
从道德上讲,您如何评价作者?还是只是以产品为基础?
在评论中留下您的名字并不是获得荣誉的好方法,因为其他人稍后可以更改文件,他们也应该获得荣誉。让我们看看其他项目如何给予作者信用。
我们以Rails为例
作者本人在提交中记入:https://github.com/rails/rails/commit/d57356bd5ad0d64ed3fb530d722f32107ea60cdf
作者在更新日志中注明:https://github.com/rails/rails/blob/master/activejob/CHANGELOG.md
作者在贡献页面中注明:https://github.com/rails/rails/graphs/contributors
其他一些项目有一个包含贡献者列表的文件:https://github.com/RubyMoney/money-rails/blob/master/CONTRIBUTORS
我个人认为让我自己作为提交作者已经足够了。更新日志也很好。