我应该如何在 Windows 上为 IT 工具构建和交付文档?还有一个限制是我不想花钱购买帮助创作工具。
在 SO 上,我们讨论算法和优化、API 和性能。但我的开发工作的可交付成果之一是文档。构建它的最佳方式是什么,我应该以什么形式交付它?
如果我要交付一组 .NET API,则 .CHM 是一种合理的交付机制。使用SHFB作为构建的一部分来构建帮助文件非常容易,如果它主要用于 Windows,.CHM 是非常易于访问的。将 .CHM 转换为 .HTM 可以使文档更广泛地访问。
但我想提供一个 ISAPI 过滤器的文档,它不会被开发人员本身使用,而是由 Windows Web 服务器管理员使用。我需要描述安装、操作和配置。我认为最终用户可能通常具有开发人员和管理技能,但无论如何,出于我的目的,文档将涵盖管理任务和操作事项。
我知道 SHFB 允许我在 .CHM 中包含常规 HTML 文件。如果我已经了解 SHFB,并且我不想花钱购买帮助创作工具,那么这是最好的方法吗?如果不是,那是什么?