@zqguo 发现好像是差了一个像素。下个版本修正

@chengfeng1992 你说的这些确实是问题。
第 1 和第 2 点是同一个问题。因为 showdoc 曾经很长一段存在一个不好发现的 bug ——当一个目录的父目录设置为自己或者一个二级目录转为三级目录的时候，会导致整个目录下的文档消失。数据库是有数据，但不会展示出来。现在已经修正问题了。
第 3 点，因为曾经调整过几次转义和安全的问题，所以调整过程中可能有用户的文档数据被转义了。确实是 showdoc 问题。现在已经兼顾好了安全和转义的问题。
第 4 点，这个问题现在还存在着，因为我觉得太长文档的情况不会多。看来我应该预先判断文档长度，来提示用户要不要关闭 html 预览。长文档特别卡的情况是因为 html 预览渲染太消耗浏览器性能。
第 5 点，showdoc 对 markdown 的转换有个改动，已经大部分支持标准语法。有没有解决极端情况下的语法，则尚不清除。
第 6 点，默认情况下，按照序号排序。当序号都相同的时候，将按 id 排序。不知道你说的问题还存在不存在。

@zqguo 原理是根据程序注释来生成。详细看文档吧

@heybuddy 让其可选的话，是一个选择。后面考虑吧

@zzf2017 正常情况它会暂停的。你这样情况可能出现了异常。建议 右击菜单，选择“ GIT BASH Here"，在弹出的命令行窗口手动执行 sh showdoc_api.sh

@heybuddy 那你们介意频繁被通知的情况吗

@heybuddy 关于更新提醒，其实我有考虑过。但是好像如果每一次修改都推送一次提醒（无论是用钉钉还是邮件提醒等方式），都太频繁了。比如说，我只是修改几个字，预览下，然后又再修改。所有我也不知道做更新提醒是不是一件好事

@dobelee 跟两年前差别还是挺多的。你有时间可以把 bug 都列出来，看是否解决了

@anxious
1，showdoc 生成的文档美观很多 ，这是个 api 文档例子 https://www.showdoc.cc/web/#/demo?page_id=9
2，showdoc 不限定特定语言或者框架，可以支持多种语言。
3，showdoc 不仅可以自动生成文档，也支持到网页端编辑，团队协作

@LWXYFER 不会。下载这个脚本 wget https://www.showdoc.cc/script/showdoc_api.sh ，直接看它地源码就知道了。它只上传注释

@cncqw 用 thinkphp3.2 是历史原因，当时是为了兼容旧版 PHP 环境。如果上新框架如 Laravel，则增加了部署难度，需要在旧 linux 服务器上安装新 php 版本。showdoc 相当多的开发者不是 php 开发者，追新不是一件好事。
此外，php 作为纯后端，VUE 用作纯前端，前后端分离反而更容易开发。
如果你说的麻烦指的是使用 vue 导致每次修改前端都要打包，那么，我想说，这是前端工程化的潮流，以后都会往这个趋势走。

@chengfeng1992 每次更新都测试过的，不会导致数据丢失。建议你仔细阅读文档操作。showdoc 升级的方式不是覆盖代码那样的升级，而是先安装然后再迁入数据。

@juneszh 批量管理功能其实是有在思考。包括批量添加 /删除项目成员到不同项目，批量删除文档。有空再更新吧。
至于不能设置回一级目录，这个 bug 好久之前修复了。去更新版本吧。

@houshengzi 这个项目出生差不多三年了。我有空就断断续续更新下

@jaycee110905 有遇到问题记得反馈下

你问其他人怎么办，不如问下过去的自己。是时候要在睡前的安静进入思维回忆里了，问问当初自己为什么能那样专注，当初的初心是怎样的。当年那个意气风大的屠龙少年呢？如果你的借口是说现在已经比当初老了，那么我想说，你的现在，是你剩余人生里最年轻的时候。不要虚度年华。
找些开源项目玩玩吧，做一些不那么功利的纯属 for fun 的玩意。It's time to do something cool ！
顺便安利下我的开源项目 https://github.com/star7th/showdoc

@liwl 去年发过一篇关于 showdoc 的文章。现在更新了也顺便发一下，顺便提升点知名度。

常见问题列表： https://www.showdoc.cc/web/#/help?page_id=16118

我写的 HTQ 的定时异步队列可满足要求

https://github.com/star7th/htq