如何开源自己的项目

http://code.ijinshan.com/trac/wiki/HowToCreatMyProject

如何开源自己的项目

• 文档属主: ZoomQuiet
• 目标读者: 所有社区成员和关注者
• 版本变更:
  • 110323 ZoomQuiet 创建

 

概述

本文包含所有相关基于开源卫士代码创立开源项目的关键信息, 为任何有志发布安全相关软件/服务/系统的人/组织,加入 开源卫士社区体系, 给出了实际的可操作的指引;

创立

理解 社区仓库关系

1. 注册  https://bitbucket.org
2. 创建项目,注意:如果期望社区最终索引和推广你的作品,请使用ok.前缀;
   • 比如说,创建 "URL安全查询器"~ Query URL Safety
   • 则项目仓库名应该是 ok.queryurlsafety
3. 安装  TortoiseHg
4. 在本地克隆项目仓库,操作命令类似
   • hg clone https://bitbucket.org/你的帐号名/ok.queryurlsafety
5. 在本地开发,使用hg ci 命令检入代码变更,定期使用hg push命令将稳定版本发布到  https://bitbucket.org
6. 在你认为合适的时候,通过 邮件列表/BBS/管理委员会邮箱 等等渠道,向开源卫士社区反馈你的项目信息

最终就有可能成为社区认证项目,反应到社区相关页面,进行共同推广,完善;-)

管理

建议在项目发布首个版本之后,充分加入到社区沟通平台中,和广大开发者交流,持续的改进你的作品:

• 问题/缺陷追踪,增进建议,应该使用 Bitbucket的Issue服务
• 日常技术讨论,建议在 开发技术讨论列表:
  • 主题: 任何有关金山开源作品的代码/缺陷/改进/调试等技术相关话题
  • 发言:  ks-deve@googlegroups.com ^{订阅后向此邮箱发信}
  • 订阅:  ks-deve+subscribe@googlegroups.com ^{向此邮箱发邮件即可}
  • 退订:  ks-deve+unsubscribe@googlegroups.com ^{向此邮箱发邮件即可}
  • 投述:  ks-deve+owner@googlegroups.com
• 日常用户交流,可以在 BBS
  • 如果需要,可以向 管理员说明,开辟专用版块
• 语音交流,可以在YY语音会谈:84544119
  • 如果需要,可以向 管理员说明,组织一次专题讲座

参考

•  Hg 即 ^{~分布式版本管理系统},参考文档: 权威指南; Hg入门; Hg小抄 ^中文版;  tip ^{~ Hg实用技巧集...}
•  HowtoScm Pythonic 配置管理
  •  AbtDvcs - 了解分布式版本管理系统
  •  Pythonic Hg使用