一、手册：

    手册写作本来与程序写作无关，但由于一般程序员都不知道手册的重要性，往往程
序写得极佳，而市场口碑却不良，以致惨遭滑铁泸之败。
    实际上，当今市场的趋势，都倾向于屏幕提示，以致于手册仅具辅助作用，帮助使
用者理解各种功能的发挥而已。
    问题就出在这里，一个功能的介绍、说明，与该功能应用的发挥，完全是不同的层
次。「屏幕提示」经常由程序员自行制作，而程序员对文字概念的应用及理解能力，往
往并不太高明，其结果可想而知。
    手册应该有专人写作，这种人既要对文字概念应用裕如，又要充份了解计算机的功
能。难的是，培养一个程序员，了不起三个月到半年，而一个能达意的作家，起码需要
三至五年。遗憾的是，一般计算机公司没有这种眼光，以为写程序需要技术，手册则随
便找人应付了事。
    手册的重要性，并非仅止于此，一个有价值的程序，一定有周详的计划，有制作的
蓝图。这种计划及蓝图，经过文字概念上的整理，应该就是手册本身。换句话说，有良
好规划的程序，必然是先有手册作为蓝图，再根据手册制作程序。

二、版本：

    程序完成以后，除非一些特殊的原因，只要有实用价值，必然需要不断改进、强化。
    这一来就面临版本更新的问题，程序员在制作之初，必须事先考虑周全。不要希望
一次把程序写得尽善美，完整无缺，不仅那是不可能的梦想，也是自找麻烦。
    任何一个人，即使是不世天才，也不可能经历人间所有的事件。而程序所需要适应
的范围，则是动态的、随着人的知识及经验不断增长。因此，一个崭新的程序一旦问世，
就成为人世间的新生事物，人的经验扩展后，新的需求即接踵而至。刚刚完成的程序，
在完成的那一剎，就已成为过去式。
    所以在程序规划时，必须高瞻远瞩，考虑得越是周全，程序的生命力越是旺盛。同
时，在另一方面，程序必须交到使用者手中，才有实际的价值。是以如何在周全的规划，
和尽快的完成工作之间，作有效的斟酌取舍，则是个难题。
    解决的方法之一，就是利用「版本」观念，将产品分为数个时期。这样，不仅产品
可以很快地交到使用者手中，而且使用者可以提供其应用经验的回馈，更有利的，是程
序得以不断地增长、成熟、完善。
    有了版本的观念，还需要对版本的制作有明确的计划，每一个版本的档案维护，修
订更正，都要有专人负责。否则，当已经上市的版本还需要修改，而新的版本业已开始
设计，若是一个不小心，分不清档案属于哪个版本时，其后果之不堪，将非局外人所能
领会的了。

三、包装：

    此处所提的「包装」，不是商业上所谓的如何将产品美化伪装起来。而是指一个程
序交到使用者手中时，应该具备哪些必备的，哪些选用的「配备程序」。
    一般大型的应用程序，经常提供很多片磁盘，要先执行一个很复杂的「初始化」程
序，才能使用。如果采用汇编语言制作，其目的本就是为了节省空间。空间小了，应该
可以避免这种多余的手续。
    这就是包装所要考虑的问题，比如说，在我们的"聚珍整合系统"中，附有如
下一些配备程序及手册：
  1,功能、操作提示或手册：
    1-1 SM.HLP：在功能提示态下，说明各功能、操作方式及注意事项。
    1-2 SMVQOQ.EXE：聚珍整合系统操作手册阅览程序
     SMVQO1.DAT--SMVQOD.DAT ：操作手册数据档。
  2,SMJOOH.EXE：繁、简体档互转程序
    SMJOOH.TAB：繁、简体转换对照表。
  3,SMJOPA.EXE：本系统与PARK文书档数据互转用。
  4,SMJOB5.EXE：为转换其它系统生成的文书档数据用。
  5,SMJIB5.EXE：转换dBASE III 数据档。
    这些程序及档案，都要放在同一片磁盘中，不仅为了方便省事，也可降低成本。
    在我们的经验中，这些工作说来容易，做来却大费周章。唯有在事先做好妥善的规
划，最后才能省时省事，达到理想的预期效果。
    仅以屏幕提示为例，由于数据所占空间太大，就导致了极大的困难。如果事先有准
备，将数据作适当的压缩，显然会省却不少麻烦。
    此外，手册的印刷，磁盘的复制，所有一切应行考虑的，都要事先想清楚。要知道，
一个应用软件，其成本完全在开发及最后的包装过程，为了成功，代价是必须先付出的。

文学书苑首页