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文档等等。

  • 相关阅读:
    postgre通过sql释放空闲连接
    LeetCode Weekly Contest 255
    响应式编程基础教程:Spring Boot 与 Lettuce 整合
    响应式编程基础教程:Spring Boot 与 R2DBC 整合
    Spring WebFlux 基础教程:WebSocket 使用
    Spring WebFlux 基础教程:参数校验
    Spring WebFlux 基础教程:快速入门
    LeetCode | 46. 全排列
    LeetCode | 买卖股票的最佳时机
    LeetCode | 动态规划_小青蛙跳楼梯
  • 原文地址:https://www.cnblogs.com/maweifeng/p/203102.html
Copyright © 2011-2022 走看看