新型交叉平台式帮助文档开发工具
就像程序员一样,技术作者也可以习惯于使用他们的工具,但是向.NET的转移通常需要有新型文档工具和方法的引入。通过多种平台对在线帮助进行访问的需要逐渐增加,这对现有的文档工作方案将造成最大的影响。
Web基于服务的本质意味着在线帮助是为用户提供协助和培训的最佳平台。对于.NET应用软件来说,在线帮助可以通过下面的方法实现:
◆基于服务器的HTML或基于Web的帮助:这样的服务器端文档可以是自定制的解决方案,也或者是利用eHelp的RoboHelp Enterprise这样的工具所开发的,RoboHelp Enterprise以RoboHelp为基础,使你可以开发基于服务器的和基于应用软件的在线帮助解决方案。
◆应用软件自身所提供的HTML帮助:目前已经有各种不同的工具可以使用,你的公司中也许就有一些。
◆Web帮助:来自于应用软件或是服务器端。
加入XML和ASP.NET
如果你的文档工作方案中不包括XML和ASP.NET,你的文档就需要进行扩展以加入这些内容。对于应用软件的最终用户来说,对XML和ASP.NET的使用也许是透明的,但你的软件开发生存周期和结构性文档也要考虑到这个问题。
这可以通过多种途径实现,其中包括:
◆将应用软件XML DTD文档化。
◆将ASP.NET代码文档化,其中包括一般性项目信息,COM对象和构成ASP.NET的其他元素。有一些自动化的文档工具可以完成这样的工作,例如Living Doc。
移动用户
在PDA的使用逐渐流行起来的同时,也许有一些技术作者和分析人员还不是很熟悉PDA的环境。此外,移动电话的功能不断增加,使他们都能够对Web进行访问。
如果你的文档化工作还扩展到了用户培训这一方面,那么你就要提供课堂和在线培训以满足人们的需要。有一些工具,例如来自eHelp的RoboDemo,他们可以让你产生运行在基于PDA的Pocket PC之上的介绍和教程,这些内容同时也可以在Web中进行访问。
接受挑战
要调整文档工作方案以满足.NET环境的需要,你就要对用户文档进行一些改动,采取策略来适应被Microsoft .NET和用户社区所支持的多种平台。以上介绍XML和ASP.NET。
【编辑推荐】