关于文档写作工具

不知大家团队都在使用什么样的文档书写工具,是不是还是和笔者一样在使用Word,也许个人或者2-3人还好办,最后合并汇总就可以了,但对于大的项目、团队、文档这样显然不合适。第一,工作无法多人协作,或者多人协作不方便;第二,效率不好,最后需要汇总组织;第三,格式转换比较麻烦,生成帮助文档格式或其他格式比较困难;第四,文档基于格式而不是数据,无法统一更改格式(模版的概念)。

先看看微软MSDN的文档:

微软VS 2005中的MSDN没有内容的页面:

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Insert introduction here.

Subhead
Insert section body here.

Subhead
Insert section body here.

Send comments about this topic to Microsoft. © Microsoft Corporation. All rights reserved.



而在其上一级页面可以有子页面的列表,如:

This section features topics related to the Web Designer environment.
In This Section
      Visual Studio Web Site Designers and Editors
      Visual Studio Web Designer Keyboard Shortcuts

至少表明,微软应该在使用一套基于Web(?)的文档书写工具,可以设定模版,可以有很多自动功能,是否Wiki?这样的工具对于团队协作,文档书写个人觉得很重要,而对于这方面的工具和资料不太熟悉,欢迎讨论。

例如Python的文档是使用Wiki工具完成,然后使用工具转换为Html格式,帮助文档,PDF文档等等。

原文地址:https://www.cnblogs.com/maweifeng/p/203102.html