一个合格的开源项目 README 应该怎么写?

2015-05-09 10:35:21 +08:00
 Septembers
1801 次点击
所在节点    问与答
7 条回复
pupboss
2015-05-09 10:39:40 +08:00
一定记得加 license😂不然你下个问题标题就是 《如何看待有人原封不动抄我源码?》
adjusted
2015-05-09 10:40:39 +08:00
LICENSE可以放到repo里面
tencoldays
2015-05-09 10:44:36 +08:00
lincanbin
2015-05-09 10:48:45 +08:00
简介(Features)
如果是GUI相关一般还有带上一些Screenshot

环境要求(Requirements)


安装/部署(Installation)
一般整站开源会带有部署说明。

使用(Usage)
如果是一个开源库,一般来说除了仓库里的Demo外,ReadMe中还会有一段实例代码。


协议(License)
lincanbin
2015-05-09 11:03:18 +08:00
https://github.com/lincanbin/Carbon-Forum

https://github.com/lincanbin/Material-Design-Avatars

顺便发两个我自己写的ReadMe,前者是一个整站,后者是一个库。
hoogle
2015-05-09 11:19:55 +08:00
还有 CI status 什么的
KexyBiscuit
2015-05-09 19:15:14 +08:00
How to compile, 对新手很重要……好吧我是新手。

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/189678

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX