在GitHub官网上如何记录项目

良好的文档是任何项目成功的关键。使文档可访问使人们能够了解项目; 使更新变得容易,确保文档保持相关性。
记录项目的两种常用方法是README文件和wiki:
README文件是其他用户更快速,更简单地了解您的工作的方法。
GitHub上的Wiki可帮助您以有用的方式提供有关项目的深入信息。
至少在你的项目中有一个README是个好主意,因为这是许多人第一次找到你的作品时会读到的东西。
创建自述文件
当你创建一个新的存储库,虽然GitHub上,选择“初始化这个资源库和自述”,除非你打算导入现有的资源库。


您的README.md文件现在可以在全新的存储库中进行编辑。您的项目名称位于顶部,后面是您在创建存储库时选择包含的任何描述。自述文件很容易在GitHub或本地修改。查看Mastering Markdown指南,了解有关如何在创建文件后修改文本的详细信息。
格式化README
自述文件通常遵循一种格式,以便立即将开发人员定位到项目的最重要方面。
项目名称:您的项目名称是人们在向下滚动到自述文件时会看到的第一个名称,并且在创建自述文件时包含在内。
描述:您的项目描述如下。一个好的描述是清楚,简短,重点。描述项目的重要性及其作用。
目录:可选地,包括一个目录,以便其他人快速浏览特别长或详细的自述文件。
安装:安装是有效自述文件的下一部分。告诉其他用户如何在本地安装项目。(可选)包含一个gifÿ

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值