大家公司技术文档都是拿什么写啊

2016-08-03 15:22:49 +08:00
 ThomasChan
rt ,最近我们公司来了个在国企工作过的 tech leader ,带来了文档编写规范一系列改革.....,其中要求技术文档落地到 word ,放 svn 上去.....

mac 上编写 word 感觉好痛苦啊..... 而且对 word 也不熟....
8820 次点击
所在节点    问与答
52 条回复
DT27
2016-08-03 15:26:16 +08:00
都要求 word 了。。。你就别想那么多了~~~
ixiaozhi
2016-08-03 15:37:19 +08:00
我用 rap
bibizhang
2016-08-03 15:39:43 +08:00
换我就辞职了
ahcat
2016-08-03 15:40:52 +08:00
用百度的 UEditor 写,然后按照公司的文档规范,通过脚本转换成指定样式的 Word 文档、 PDF 文档。
daya
2016-08-03 15:41:16 +08:00
用键盘(滑稽)
checgg
2016-08-03 16:07:20 +08:00
README.md 不是挺好的吗。
knktc
2016-08-03 16:09:08 +08:00
用 wiki 写……
tomczhen
2016-08-03 16:15:18 +08:00
之前用的 hexo 在内网搭了个,利用 git hook 做的自动部署更新。后面用了 gitlab 的 wiki ,然后创建了一个仓库放一些交流文档。

虽然目前只有我一个人写就是了。
ThomasChan
2016-08-03 17:55:25 +08:00
@bibizhang 😂 那还不至于
hpeng
2016-08-03 18:01:09 +08:00
领导说什么就什么啦, word 很聪明的,你用 md 写,生成 pdf ,转换成 word 。
neil90
2016-08-03 18:16:37 +08:00
我用 Pages
iyaozhen
2016-08-03 18:31:10 +08:00
用 word 。有统一模板
office for Mac 很好用呀, markdown 你都会 word 还有啥难的啊
scnace
2016-08-03 18:56:25 +08:00
md->pdf->word +1
cxbig
2016-08-03 19:01:20 +08:00
技术文档一律 Markdown 。可放项目 /docs/目录或独立 repo 。至于 SVN 还是 Git 无所谓。
21grams
2016-08-03 19:01:48 +08:00
我觉得用 word 挺好的,文档是给别人看的,你不能光自己一个人 high 。
zhouxuchen
2016-08-03 19:02:29 +08:00
文档放禅道,用的好像是 ueditor ,挺蛋疼的
nisekoi
2016-08-03 19:02:56 +08:00
apidocjs 自动生成
yjxjn
2016-08-03 19:03:32 +08:00
IBM notes
Tneciv
2016-08-03 19:15:52 +08:00
本来我一直用 gitbook 写 然后生成 html 给出去 然而 换了新领导 说这样的文档显得不专业 要用 word 写完转成 pdf …
我真的是没话说 再结合其他事情 已经准备走了…
changqingshuya
2016-08-03 19:43:37 +08:00
为啥不用 wiki

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/296840

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX