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

开源项目README目录规范

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

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

    README 驱动开发

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

    44510

    【三】编写README.md

    前言现在项目已经有了,但是我们还没有正式的介绍我们的项目和添加 License 文件,这一章我们就一起来看看如何写一个README.md内容为了更好的写出好的一个 README.md,我们先看看优秀的开源项目都是怎么写的...tdesign-vue-next:https://github.com/Tencent/tdesign-vue-next/blob/develop/README-zh_CN.mdVue:https://...好了,看过这三个项目后,我们大概知道一个项目的 README.md 需要包含哪些内容,接下来我们就来尝试写下自己项目的 README.md 。...语言默认提供 英语 和 中文 的 README.md,这里我们也提供两个版本的 README.md,先将中文的写好,再进行翻译即可。安装基础的安装使用教程,这里我们还没开发完成,所以暂时留空即可。.../blob/main/README.md总结这一章最主要的其实就是徽章的生成,毕竟以大家的聪明才智,写个 README.md 肯定是手到擒来。

    9010

    怎么写开源项目的README

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

    63720

    基于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

    1.1K20
    领券