21.如何编写 README?

文章提供了创建优质README.md文件的建议,包括何时添加信息、是否包含架构等。推荐了如ReadMe.so在线编辑器、Gitbadges和GithubStats等工具来增强自述文件的功能和视觉效果,并鼓励从其他项目中获取灵感。
摘要由CSDN通过智能技术生成

README.md 文件,每个项目的开始。

当您从事开源项目或与团队合作时,创建一个好的 README 始终是一个挑战。我们总是有很多关于我们可以做什么、添加、删除……的问题。

我应该添加此信息吗?

是不是太多了?

我应该添加架构吗?

因此,为了帮助您在可以做什么、应该做什么以及如何做方面有一个良好的开端,这里是创建一个 README 项目。
在这里插入图片描述
正如我们谈论的如何编写变更日志?,本文档将为您提供创建高效自述文件的所有指南。此外,为了帮助您创建自述文件,还有大量非常酷的工具可供使用,例如

ReadMe.so:使用在线编辑器创建您的自述文件
在这里插入图片描述
Git badges : 将一些重要信息显示为徽章
在这里插入图片描述

Github Stats:显示有关您的 github 统计信息的一些信息
在这里插入图片描述
… 等等!

您可以在线查看,有很多工具,一些 git 项目列出了它们:

https://github.com/dhyeythumar/awesome-readme-tools
https://github.com/matiasingers/awesome-readme
现在您拥有创建高效 README 的所有工具!🚀

如果您需要更多灵感,请不要犹豫,查看其他项目的 README 文件或查看一些帖子。网上有很多帖子都在谈论很酷的 README 设计。

希望对您有所帮助!🍺

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Q shen

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值