zoukankan      html  css  js  c++  java
  • 关于文档写作工具

    不知大家团队都在使用什么样的文档书写工具,是不是还是和笔者一样在使用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文档等等。

  • 相关阅读:
    java Boolean和boolean的区别
    stack.isEmpty()和empty()
    mysql中文、英文别名排序问题,order by 关键字详解
    数组中array==null和array.length==0的区别
    7.9总结
    7.8总结
    6.25总结
    6.27总结
    6.29总结
    6.28总结
  • 原文地址:https://www.cnblogs.com/maweifeng/p/203102.html
Copyright © 2011-2022 走看看