首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

开源项目README目录规范

README文档的组成部分 看过很多开源框架的README文档,综合一下,项目简介要说明几个你的开源项目用户想迫切了解的问题,这包括: 这个开源项目是做什么的? 这个项目是什么语言编写的?...混淆(可选) (九)关于作者/组织及交流方式等信息 (十)贡献者/贡献组织 (十一)鸣谢 (十二)版权信息 国际化 Github是面向全球的一个开源网站,所以不要局限于中文文档,建议写一个英文的README...集成方式 这是 README 中最重要的部分,你需要说明这个项目如何使用,这包括: 如何下载这个项目:一般情况下 git clone 该项目地址即可,当然你也可以提供其他包管理下载安装方式; 运行环境...你可以在项目根目录新建一个 CONTRIBUTING 进行详细的说明并在 README 中添加其文件锚链接。 比如: ? ?

1.8K70
您找到你想要的搜索结果了吗?
是的
没有找到

README 驱动开发

每次挖新坑的时候,经常性地都要花很多的时间,想着怎么编写 README、完善 README。而就是这么一个简单的 README 的编写,它都要花费我相当长的时间,或是几个小时,或是几天。...问题来了,我真的是在写 README 吗? 引子 1:不止自述的 README README,又称“自述文件”,是随着软件发布的一种说明文件,里面通常包含有软件的描述或使用的注意事项。...而 GitHub 使用了 README 作为项目的『首页』,作为了整个开源项目门房。而正是这个首页,让我们重新意识到 README 的重要性,刷新了 README 的作用。...README 驱动开发 由于,看不到一个成熟的 RDD 定义,所以我先按我的理解定义出第一个版本的 README 驱动开发: README 驱动开发是一种通过事先编写 README 的方式,以一步步驱动出受用户欢迎产品的软件开发方法论...README 测试 顺便一提,最近我开始在寻找一种新的测试方式,README 测试。 既然一个 README 可以写成结构化的,那么它必然也是可以测试的。

42310

怎么写开源项目的README

维护者吸引更多长期贡献者的方法之一是写一个规范的 README。这里,参照一些流行的开源库中的 README 整理了一份清单,让你创建一个能吸引贡献者加入你的社区的 README。...我为什么要写 README? 就像找工作要写个人简历一样,为自己的开源项目写一个优秀的 README 同样重要。你README 可以为新用户和潜在贡献者提供了对我们项目的第一印象。...说白了,你的 Contributing.md 可以让贡献者在你的版本库中提出和合并拉动请求,而你的 README 则指导用户如何使用你的项目。 我应该在 README 中写些什么?...这个例子来自 use-shopping-cart 可以附加一点 目录(这里有一个关于自动生成目录的文档) 项目的技术堆栈和功能 已经在用的产品 项目的用户界面截图 依赖 已知的问题 怎么把它弄漂亮点 试试使用Readme.so...,这是由Katherine Peterson建立的开源项目,可以轻松建立和定制README的所有部分。

59220

从《README》了解u-boot

了解u-boot的方式有很多种,以下从U-boot官方文档README学习。...U-Boot 的开发与 Linux 息息相关:部分源代码来源于 Linux 源代码树,我们有一些共同的头文件,并专门提供了支持 Linux 镜像的引导。 已经注意使该软件易于配置和扩展。...最近,U-Boot 添加了 Linux 内核使用的 Kbuild 基础架构,允许您使用“make menuconfig”命令来配置您的构建。...TQM823L 模块类型: cd u-boot //进入u-boot根目录 make TQM823L_defconfig 注意:如果您正在寻找您确定曾经存在但现在丢失的板的默认配置文件,请检查文件 doc/README.scrapyard...preloader_console_init() - 通常这是通过定义CONFIG_SPL_BOARD_INIT 然后提供包含此调用的 spl_board_init() 函数来完成的 加载 U-Boot 或(in falcon mode)Linux

57220

基于Vercel部署github-readme-stats

基于Vercel部署github-readme-stats ​ Github主页美化,将github-readme-stats部署到Vercel上 步骤说明 注册、登录vercel.com...frok github-readme-stats 仓库,并授予vercel访问该仓库的权限 从Git仓库中导入仓库信息,并配置个人访问令牌环境变量 参考配置 注册、登录vercel.com...​ 可选用第三方账号直接绑定即可(vercel在很多场景的应用还是可行的) frok github-readme-stats 仓库,并授予vercel访问该仓库的权限 ​ 可在Github...填充名称,配置默认即可)需注意Token生成之后只提示一次需自行保存,且离开页面之后无法再次查看 ​ New Project -> Import Git Repository -> 选择github-readme-stats...redirects": [ { "source": "/", "destination": "https://github.com/anuraghazra/github-readme-stats

1K20

一键生成 Helm Chart README 文档

而 Helm Chart 中的 README.md 文件就承担了文档的作用,该文件会介绍这个 Helm Chart 的基本信息、使用方式以及参数配置等,用户可以通过该文档的指引,配置符合自己需求的参数,...该文件会包含有关 charts 的元数据,以及 value.yaml 中的参数,同时还可以引用子模板(默认为 README.md.gotmpl),进一步定制生成的内容。...pullPolicy: IfNotPresent 自定义模板 可以新建 README.md.gotmpl 模板来进一步定制 README.md 的输出样式。...README.md.gotmpl 文件的内容如下,可以在模板中插入 Markdown 来充实 README.md 的内容,以及改变展示内容的顺序: {{ template "chart.header"...文件,无需逐个寻找和修改,甚至将其集成到 CI 流水线中,自动生成最新的 README.md,保证文档和代码的一致。

1.4K10
领券