原文:如何写一个通用的README规范

背景 我们平常在进行项目开发时,一般都会把代码上传至代码托管平台上方便管理和维护。目前我厂使用的托管平台是SVN,国内外还有一些比较知名的代码托管平台,比如github Gitlab BitBucket,码云和码市等。 但我们在多人合作开发下,经常碰到的最头疼的问题是,其他开发者在交接给我们一个项目时只是对项目目前现有的功能简单的描述了下,我们在后续迭代功能时突然发现连最基本的项目如何运行都没有 ...

2018-05-01 21:36 0 3806 推荐指数:

查看详情

如何写一个优秀的GitHub项目README文档?

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

Thu Jan 24 18:02:00 CST 2019 0 649
【github】论怎么去一个高大上的ReadMe

前言 以前我时常觉得,自己ReadMe很单调乏味,但后来仔细研究一下后,发现有很多方式可以让ReadMe在简洁的基础上变得好看些,所以在这里和大家分享,如果大家有更好的想法,也非常欢迎在评论区留言哦 美化方案 加彩色徽章:介绍npm版本,证书类型 ...

Mon Sep 09 16:02:00 CST 2019 9 942
什么是接口文档,如何写接口,有什么规范

一、什么是接口文档?在项目开发中,web项目的前后端分离开发,APP开发,需要由前后端工程师共同定义接口,编写接口文档,之后大家都根据这个接口文档进行开发,到项目结束前都要一直维护。 二、为什么要写接口文档?1、项目开发过程中前后端工程师有一个统一的文件进行沟通交流开发 ...

Fri Oct 13 06:50:00 CST 2017 0 2862
rasa 如何写一个故事

设计故事 在设计故事时,需要考虑两组对话交互:快乐路径和不快乐路径。快乐路径描述用户何时按照您的预期遵循对话流程,并在出现提示时始终提供必要的信息。然而,用户经常会因为问题、闲聊或其他问题而偏离愉快 ...

Wed Sep 01 22:54:00 CST 2021 0 233
matlab如何写一个

类是一种数据类型,与普通的数据类型不同的是类不仅包含数据,还包含对数据的操作,类把数据和数据操作方法封装在一起,作为一个整体参与程序的运行。类具有可继承性,创建一个新的类的时候,可以在一个基类中添加成员派生出新类。类的变量和类的实例是不同的,类的实例是动态分配的内存区域,通常称类的实例维“对象 ...

Mon Sep 26 18:48:00 CST 2016 0 4046
如何写一个简单的shell

如何写一个简单的shell 看完《UNIX环境高级编程》后我就一直想一个简单的shell来作为练习,因为有事断断续续的写了好几个月,如今写了差不多来总结一下。 源代码放在了Github: https://github.com/yibo141/Oh-Shell 简单的分析 我们的shell ...

Fri Aug 26 18:05:00 CST 2016 0 3524
【Android】如何写一个JsBridge

JsBridge 简介 Android JsBridge 就是用来在 Android app的原生 java 代码与 javascript 代码中架设通信(调用)桥梁的辅助工具。 原文地址点这里 ...

Mon Apr 18 09:03:00 CST 2016 0 4945
如何写一个jQuery插件

jQuery 插件开发模式 jQuery 的插件开发模式主要有三种: 通过$.extend()来扩展jQuery 通过$.fn向jQuery添加新的方法 通过$.widget()应用 ...

Thu Apr 14 23:59:00 CST 2016 1 3836
 
粤ICP备18138465号  © 2018-2025 CODEPRJ.COM