如何编写友好的说明文档？

lochpure 的个人博客 / 0 / 3 / 创建于 5年前 / 更新于 5年前

一个优秀的项目应该有一个友好的说明文档，严格意义上讲，说明文档应该包括以下几点：

项目简介及创作动机
项目维护、CI、依赖更新状态（如果有）
features & 适用人群
运行的平台或硬件要求
重要依赖
如何安装与测试
使用示例及文档地址
贡献指南
License
鸣谢
其它特有的信息

本作品采用《CC 协议》，转载必须注明作者和本文链接

空舟湖上~ ——Jouzeyu

版主 1.3k 声望

打工 @ 某不知名公司

每一个想要学习的瞬间，都有可能是未来的你在向你求救……

《L02 从零构建论坛系统》

以构建论坛项目 LaraBBS 为线索，展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。

《L01 基础入门》

我们将带你从零开发一个项目并部署到线上，本课程教授 Web 开发中专业、实用的技能，如 Git 工作流、Laravel Mix 前端工作流等。

推荐文章：

更多推荐...

价值千万的诊所saas项目正式开源 12 / 13 |

Dcat-Plus-Admin：dcat-admin框架的超级增强版，开发效率提升200%！ 15 / 16 |

用 Laravel12 Startkit 做了一个 composer 私有包托管平台 😂 点赞超过 20 个开源，看看需要的人多不多 28 / 20 |

如何打造令后端面试官印象深刻的简历？ 16 / 10 |

花了四个月打磨的 Laravel Plus 开源 34 / 101 |

冯老师的困惑 —— 一个跑了两年的 BUG 22 / 18 |

讨论数量: 3

小李世界

Laravel 8.x 译者 2.0k 声望 / Doge 先锋 @ dogeow.com

不错，借鉴下，准备更新下文档 :+1:

5年前评论

caijunduo

课程读者 90 声望

M.

5年前评论

839891627

课程读者 127 声望

附送 https://github.com/ruanyf/document-style-g...

5年前评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容，与人为善，比聪明更重要！

帮助

打工 @ 某不知名公司

私信

文章归档

1 篇 2021 年 8 月 1 篇 2021 年 7 月 1 篇 2021 年 4 月 1 篇 2020 年 9 月 1 篇 2020 年 6 月 1 篇 2020 年 5 月 4 篇 2020 年 4 月 3 篇 2020 年 3 月 5 篇 2020 年 2 月 3 篇 2019 年 12 月 5 篇 2019 年 11 月 1 篇 2019 年 10 月 6 篇 2019 年 9 月

4年前从Git向Git-Flow出发 4年前从http到https你可以这样做 4年前 laravel线上环境表单验证重定向问题解决方案 5年前 mac 10.15版本使用 phpize 命令解决方案 5年前 Ubuntu 搭建 Yapi 接口文档平台

83 使用 Git 实现 Laravel 项目的自动化部署 75 记录一下常用的拓展包（2020/4/22 更新） 33 我们为什么很难坚持下去 32 从零开始搭建一个 demo 项目 17 安装 Laravel/horizon 踩过的坑

博客标签

拓展包推荐

拿来即用系列

Jou的解决方案系列

成为赞助商