Github项目README.md模板 README作为说明文件,作用是让浏览者快速、鸟瞰式地了解项目。 为了做到这点,写README的时候应该注意层次和格式,用Markdown书写为佳。 一般至少包含三大部分,第一是介绍项目背景和用处,第二是使用方法(包括导入/安装,暴露的调用接口等),第三遵守的协议。
具体可以参照这份模板,模板本身已放到Github。
关于我,欢迎关注
博客:一旬一题 掘金:https://juejin.im/user/57ff552d5bbb50005b4e9ef9
持续关注和分享:Android 性能调优、单元测试和重构、实用中间件、各种好玩的特效和黑科技、和小众刁钻没卵用需求的折腾记录。 (如果你想打造个人品牌,把自己的介绍放在这里也是可以的)
Github项目README.md模板
(项目背景/作用介绍)
把使用了该项目的案例放在这里。可以放APK下载链接,或者简单放几张截图。
(示例一开始就放出来,方便浏览者一眼就看出是不是想找的东西)
-
特性A
-
特性B
###原理说明(可选) 阐述项目是基于什么思路设计的
Gradle:
compile 'xxx'
(说明项目的配置方法,android开源库多用Gradle导入)
怎么使用,有哪些步骤哪些接口。
比如混淆方法等
接下来的开发/维护计划。
遵守的协议