什么是最好的做法,用于释放一个开放源码项目?[关闭]
-
05-09-2019 - |
题
我们有一个很酷的小网络框架内,我们已经成功地使用在数十家客户的项目。我们正计划发布这个软件的社区。然而,我紧握我的手有什么应当/应该不去上一个新的开放源码软件项目的网页。什么事情该网站必须有?文档?维基?一个链接到下载?还有什么?
而且,一个相关但是可能不同的问题是我们如何开始标志着布的数字。所有我们内部使用的是SVN邮票。是否有一个好的方法来确定何时开始叫什版0.9与1.0和1.1等?
解决方案
您可以了解开源项目托管站点所提供的功能:
- 充当该项目“一站式商店”的网站
- 文档,可能采用 wiki 形式
- 允许浏览、匿名签出以及经过身份验证和授权提交的源存储库
- 问题跟踪和新功能请求
至于版本号...我不认为 任何人的 找到了最好的方法:)经过最少的思考,我会考虑:
- v1.0 应该可供生产使用
- 主要版本号的更改可能会完全失去向后兼容性(如果有必要的话 - 但这几乎不是一个目标!)
- 次要版本号更改通常应该是大部分兼容的 - 弃用可能比删除/重命名 API 更好
- 小于次要版本号的更改应仅包括次要功能添加(如果有)和错误/性能修复
其他提示
在版本控制,我觉得从开始的绝对最好的地方是语义版本。
在0.9 / 1.0 / 1.1 / 1.0.1 / ...版本标记仅用于营销目的(在它的良好的感觉)。这使您的用户/客户,以确定是否释放是主要的,次要的或错误修复以及你是否认为这是成熟的或没有。
提供最小值为源。其他交付取决于你是愿意帮助你的用户,为他们提供支持。
选择一个网站来承载源上第一(SourceForge上,例如)。获取源那里一个版本控制系统与匿名结账。在那里获得的电子邮件地址的人与您联系。
调用此第一版本0.1。这是因为你没有文档尚未支持该项目。
然后呼吸。
然后开始寻找文档,像一个wiki。一旦你拥有它全部覆盖,在细节的基本水平,你认为释放准备一些黄金时间,然后移动到1.0,并开始提供二进制下载。
看看GitHub的或谷歌代码。它们提供了自己的开源项目的一个很好的起点。你可以描述你的项目,文件化的维基,使用git或svn为您的存储库,并提供下载有问题跟踪和多开发管理在一起。尼斯环境开箱从学习和使用它们。
有关版本号:我不推荐0.9这样的预发布版。原因?什么版本1.9?难道是主要版本1的第9次发布或者是它释放的最后一个预发布版2?我的发布标准在这里描述下: http://code.google.com/p /海涂-EAS /维基/ ReleaseStandard 。我使用的是三号码的方案,主要,次要,和修复,具有状态码,α,β,γ,以及发布日期在一起。所以我能够并行处理多个版本容易。
希望这有助于。
MUE