原文:如何编写合格的项目说明[ReadMe]文档?

昨天有一位同学在微博上问我关于GitHub 上为何Build 一个New Repository GitHub文件目录结构中为何总是存在Read ME.rb格式的文件 如下: 其实如果当你打包或是开源协议授权方式分发你的Source Code.在构建完整项目结构的根目录下应该有一个名为ReadMe的文件来说明当前版本源码结构或版本信息.如果你常看开源项目也会发现一个规律.在你拿到一个源码解压后第一件 ...

2012-06-20 12:06 0 13700 推荐指数:

查看详情

README.md文档编写

文章参考自:如何为开发项目编写规范的README文件(windows),此文详解 - 战争热诚 - 博客园 (cnblogs.com) 为什么要写这篇博客?   其实我是一个入坑已经半年的程序员,因为不是计算机专业,只能自己摸索,所以我深知博客的重要性。每次我的学习笔记啊,项目的,面试题 ...

Sat Oct 09 01:02:00 CST 2021 0 176
SDWebImage ReadMe.md文档简单说明

SDWebImage ReadMe.md 文档 附:SDWebImage框架github下载地址:https://github.com/rs/SDWebImage 注1:该文章简单翻译了SDWebImage最新版本(3.8.1)的readMe.md,时间紧促,如有不当请指正修改,十分感激。 注 ...

Fri Jan 08 02:00:00 CST 2016 5 5548
如何写一个优秀的GitHub项目README文档

今天给大家介绍一个Github上的README文档写作教程模版,该模版目前获得6634颗星星,2296Fork,相对而言,还是比较得到大家认可的。不花哨,不别出心裁,一个比较实用的,普适性的架子;所谓教科书式,不外如此。原文是英语,大神可直接看戳我查看。下面是我翻译的中文版(未完全按照原文翻译 ...

Thu Jan 24 18:02:00 CST 2019 0 649
如何为开发项目编写规范的README文件(windows),此文详解

为什么要写这篇博客?   其实我是一个入坑已经半年的程序员,因为不是计算机专业,只能自己摸索,所以我深知博客的重要性。每次我的学习笔记啊,项目的,面试题啊,有的,只要有时间,我肯定上传上来,一方面自己可以随时随地的看,另一方面也可以方便大家。   了解一个项目,恐怕首先都是通过其Readme ...

Tue Mar 20 17:45:00 CST 2018 4 38249
使用GitBook编写项目文档

GitBook简介 GitBook 是使用 GitHub / Git 和 Markdown(或AsciiDoc)构建漂亮书籍的命令行工具(和Node.js库); GitBook 可以将您的内 ...

Tue Oct 30 08:48:00 CST 2018 0 2391
项目开发中编写文档

软件开发中文档编写是一个不可缺少的环节,常见的如《需求分析》、《概要分析》、《数据库设计》等。在“软件人”的阵营里向来存在两种观点,注重文档还是关心代码。一直争论多少年了,好像都没有一个真正的定乱。如果大项目且开发周期相对合理,很多时候项目组一定会安排进行相关开发文档编写;但对于周期短 ...

Mon Jan 27 05:53:00 CST 2014 0 10439
用github page为自己的项目编写文档

———————————————— 一、用md文件建立网页这一步要做的就是把四个实验报告做出来。1、首先为了方便管理,我们在ML下创建一个名为docs的文件夹。 2、然后在修改设置, ...

Fri Nov 22 18:51:00 CST 2019 0 448
从零开始编写自己的C#框架(4)——文档编写说明

  在写本系列的过程中,了解得越多越不知道从哪里做为切入点来写,几乎每个知识点展开来说都可以写成一本书。而自己在写作与文档编写方面来说,还是一个初鸟级别,所以只能从大方面说说,在本框架开发所需的范围内来讲述相关要用到的知识点,至于要更深入的去了解,请大家观看其他大牛的博客或购买书籍来学习 ...

Thu Apr 10 17:11:00 CST 2014 25 13796
 
粤ICP备18138465号  © 2018-2025 CODEPRJ.COM