项目文档模板_用于启动项目文档的模板
项目文档模板
假设您已经创建了一个程序或启动了一个开源项目,现在您已经引起了人们的关注。 他们开始提出越来越多的问题,越来越多的宝贵开发人员需要时间来回答。 它们会填满您的邮箱,有时甚至会向您的IRC频道发送垃圾邮件,并经常重复相同的问题。 您知道需要以书面形式提供一些帮助用户的信息。 但是你应该从哪里开始呢? 您可以使用哪些工具? 您选择哪种输出格式? 您必须涵盖哪些主题?
通常这是人们退出并实际上不开始写作的地方。 毕竟,您是开发人员,而不是技术作家,对吗? 尽管这可能是正确的,但请不要忘记文档是项目的重要组成部分。
动笔
我认为您是从头开始的,因此启动您喜欢的编辑器并编写第一行文档。 将该第一个文件称为README。 使用纯文本作为文件格式,因为它可以轻松地进行版本控制。
使用Markdown或reStructuredText等标记语言,
例如,使用pandoc可以轻松地将文本转换为所需的输出格式,例如PDF或HTML。 另外,大多数代码托管平台都可以解析README文件并正确渲染大多数标记语言。
快速入门模板
要概述文档,您可以使用下面的降价格式的模板。 以版本标识符或日期开头。 使用ISO日期格式或写出月份的名称,以便其他国家/地区的人不会混淆月份和月份。
README v0.0 / 2015年6月1日
# 项目名称
## 介绍
一两个段落(最多)为您的用户提供项目目的和功能的概述。 由于有时一张图片值一千个字,因此请在适当时附上屏幕截图。
##用法
提供简短的代码段(如果适用)或简短的使用说明
##贡献
提供有关如何参与项目修补程序的说明。
## 救命
说明可以使用哪些沟通渠道来请求帮助。 具有良好记录的通讯渠道是邮件列表,IRC渠道和论坛。 另外,请务必告诉您经验丰富的用户如何以及在何处提交错误或功能请求,有可能使他们成为项目参与者。
##安装
### 要求
列出您的项目所需的任何东西,以使其按预期工作。
###安装
描述如何安装程序。 准确并举一些例子。 不要以为您的用户知道如何从我的github存储库克隆 。 请记住,您的某些用户可能对系统管理或软件开发完全不熟练。
###配置
安装软件后,用户可能需要对其进行配置。 列出配置选项,并说明如何以及在何处进行设置。
##积分
有时也称为Authors ,这是项目贡献者的列表。
## 联系
人们可能出于各种原因希望与您联系,从DCMA撤下通知到有关如何向您的项目捐款的问题,不一而足。 提供联系信息,例如电子邮件地址,并请记住,某些国家/地区可能会依法要求某些信息,例如完整的邮政地址,网站URL和公司名称。
## 执照
该项目已获得[插入许可证]的许可。 许可证应该在一个单独的文件LICENSE中,因此不要在文档中对其进行详细说明。 另外,不要忘记指定您使用的第三方库和程序的许可证。
有时在文档的开头包含目录(TOC)是有意义的,尤其是当您的README文件包含多个段落时。 如果您认为README文件太大,则将一些更详细的部分(例如安装或配置部分)放入其自己的文件中。
结论
编写您的第一个文档似乎并不像您最初想的那样费力或费时,是吗? 现在,您可以建立一个起点。 不要忘记更新自述文件,以使其与项目的开发和新发行版保持一致。
碟
本文是Rikki Endsley协调的Doc Dish专栏的一部分。 要撰写本专栏文章,请提交您的故事创意或通过open@opensource.com与我们联系。
翻译自: https://opensource.com/business/15/6/template-starting-project-documentation
项目文档模板
项目文档模板_用于启动项目文档的模板相关推荐
- 苹果cms10好看的模板_简洁黑色自适应苹果CMSv10网站模板
苹果cms10好看的模板_简洁黑色自适应苹果CMSv10影视模板 我的主题网[第十四套]苹果CMSv10最新原创酷黑渐变特色自适应视频站模板 酷黑渐变特色功能触动封面直接播放视频内容,苹果cms自适应 ...
- python怎么建立项目经理部的基本原则_一个关于项目经理的故事
一个关于项目经理的故事 项目经理的养成日记 L在2001年毕业之后加入到了福建实达公司. 在今天这个公司几乎是很少有人听说了,但在当年实达还是在IT这片江湖里有些地位的.当年实达的产品线非常全,有网络 ...
- vs中如和根据项目生成类图_迁移WPF项目到.NET Core
综述# .NET CORE 3.0开始,桌面端支持WPF了.很多.NET FRAMEWORK的项目已经跑了一阵子了,不是很有必要支持.NET CORE,不过最近用一个程序,为了贯彻一些C# 8的特性, ...
- 项目经历怎么写_这样写项目经历可以锦上添花
昨天我们详细介绍了写好工作经历的5个技巧,在这些技巧中,最重要的是量化思维!今天再来说说困扰大家已久的项目经历是怎么回事! 为什么要写项目经历?大多数人写项目经历是因为求职网站上有这个模块的要求,如果 ...
- velocity模板_使用Velocity进行客户端和服务器端模板
以标准表示或交换格式(例如HTML和XML)操作和转换文本数据是每个软件开发人员都参与的频繁且通常乏味的活动. 模板引擎可以通过在模板中维护输出的静态部分,同时动态生成和定位变化部分来促进此过程. V ...
- 微软crm在哪新建审批模板_如何在Microsoft Word中创建模板
微软crm在哪新建审批模板 Templates let you configure all the relevant settings you want pre-applied to document ...
- 应付账款账龄分析模板_超全的财务会计表单模板分享
还在为了工作而心乱如麻? 还在网上茫无头绪的找模板? 还在对找的而模板无所适从? 相信不少新入门的会计 甚至一些做了不少时间的老会计 也时常会为一些财务表格而发愁 如果还有朋友还在为了这事而心乱如麻 ...
- 浙江大学 计算机学院 刘辉,【夏文莉】_浙江大学关于夏文莉等职务任免的通知...
浙江大学 时间:2017年09月25日 访问次数:13 源地址 2017]42号 各学院(系),行政各部门,各校区管委会,直属各单位: 2017年8月17日学校决定: 夏文莉任科学技术研究院常务 ...
- wordpress模板_如何在WordPress中创建类别模板
wordpress模板 Have you visited a site where each category has different layout? In WordPress theme dev ...
- h5 bootstrap 小程序模板_汉中餐饮行业支付宝小程序模板
汉中餐饮行业支付宝小程序模板 r2y8w85 汉中餐饮行业支付宝小程序模板 在上,都能够开设自身的美妆旗舰店,根据这类方法开展精细化的服务,随后去一些线下用户流量.命名合适的小程序名称商城在搭建过程之 ...
最新文章
- Linux拥有良好的界面
- 每周AI应用方案精选:虹膜识别;基于深度学习人脸识别方案等
- 封装caffe-windows-cpu(支持模型有多个输出)
- IOS开发学习记录第3天之C语言学习
- python读取数据流_python3+pyshark读取wireshark数据包并追踪telnet数据流
- 2020 年最新版 68 道Redis面试题,20000 字干货,赶紧收藏起来备用!
- 字母c语言定义为什么变量,C语言为什么要规定对所用到的变量要“先定义,后使用”...
- 清华大学2019计算机录取分数线,2019年清华大学各省各批次录取分数线
- .net winform 的 OnKeyDown 与 方向键
- 【Unity3D插件】Exploder插件分享《物体爆炸效果插件》
- python --给图片加文字
- 密码学:流加密法与块加密法
- 发生系统错误1067
- SQL Server 2017无法启动,提示“系统找不到指定的文件”【虚拟机内安装的】
- 通过read()读文件
- Jmeter+Ant+Jenkins自动化接口测试框架
- 日期时间工具(dayjs)的使用
- 教练机飞行原理与操控方法
- Python用opencv实现动态识别二维码,以及加强版Python GUI(图像用户界面编程)
- SQL SERVER CEILING 函数 取整时的坑。。。
热门文章
- 15000字看完lululemon增长攻略
- vim 修改注释颜色 tab键
- 爬虫---涨跌停股票池信息----(东方财富)
- ValueError: Error initializing torch.distributed using tcp:// rendezvous: port number missing
- QFT的问世 高斯定理
- cocos creator 加载微信云端图片
- 计算机专业自主招生有哪些学校,自主招生的学校类型有哪些
- pip安装pytorch清华_镜像安装pytorch的简便方法总结
- 一个人摘了一些桃子,第一天卖掉了一半,又吃了一个,第二天卖掉了一半,又吃了一个,以后天天都是如此处理,到第n天发现桃子只剩下一个桃子,n是参数,返回值是一共摘的桃子数。 求两个数的最大公约数
- The way的用法