欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

用户手册

程序员文章站 2022-06-27 19:49:56
用户手册是作者经过实践活动形成的经验。包括实践过程中所有的记录,正确的,或者错误的。用户手册应该分为两部分,经验与理论。 经验不是指实践的过程,应该是实践的结果。用户不需要经历作者的实践活动,他们需要的是能够直接指导其开始FreeNAS服务器设置的工作。用户不需要知道一步一步的做什么,需要的是我有一 ......

用户手册是作者经过实践活动形成的经验。包括实践过程中所有的记录,正确的,或者错误的。用户手册应该分为两部分,经验与理论。

 
经验不是指实践的过程,应该是实践的结果。用户不需要经历作者的实践活动,他们需要的是能够直接指导其开始FreeNAS服务器设置的工作。用户不需要知道一步一步的做什么,需要的是我有一个要求,如何通过理论实现这个要求。
 
经验,用户手册的第一部分是作者实现自身要求的最简单的经历。
 
用户作者想保存一些照片、音频与电子图书资料。照片、视频只能有作者或者妻子上传,或者把保存在服务器上的照片与视频删除。孩子与作者的父母亲只能浏览照片,播放视频的操作。编程方面的图书只需要用户作者上传与读写。其他人无任何访问的权限。妻子有自己的私密照片,只有作者与妻子两个人可以上传与查看。孩子或者作者的父母浏览照片,播放视频的时候不需要输入密码,只要联接服务器就可以操作。
 
作者想增加一个保存自己文章的文件夹。这个文件夹只属于作者自己。其他任何人不能共享。如果有朋友来到家里,可以查看浏览指定的照片或者播放视频。所有到来的朋友是否可以自动浏览共享指定的数据。要求登录方便,不需要复杂的操作。
 
可以通过网络盒子在电视机上浏览照片,播放视频。手机(安桌或苹果)、电脑(台式机或者笔记本),都可以共享上传资料数据。
 
用户手册首先是一个实例场景,是手册作者实现自身要求并经过实践检验的行为活动。然后是理论部分。这部分应该有综合有分析,按照场景中的要求提供各种理论的指导工作。简单说,场景中有一个要求建立私有的文档资料文件夹。这是怎么实现的呢?对于任何建立这种要求的操作,都具有共同的属性与方法,或者说操作步骤。
 
理论就是把场景中的特殊性上升为普遍性。用户根据场景中的要求,找到自己的如何操作的设置的。如果用户的要求没有出现在场景中,那么用户可以根据自己的特殊要求,通过对理论的综合与分析,找到解决自己问题的办法。
 
所以用户手册中场景的设计要尽可能的全面,这些场景不能是作者自己想象出来的,而是从网络上收集不同的用户的需求。把大数人不同需要,分门别类的综合与分析。找出各种需要之间的共性。把这种共性设计在场景中。
 
作者通过实践活动实现了场景中的要求,也即实现了现实生活中部分用户的要求。从实践的活动中,作者不断的抽象,也即由具体转化为抽象,综合分析得到共性的东西,这就是理论的普遍性意义。
 
如何的从场景中的特殊性上升为理论的为普遍性?作者在场景中要建立一个私有的保存自己文章的文件夹。只能自己上传读写操作。从特殊性来说这是保存私有的文章。从普遍性来说,保存私有的照片、视频、任何私有的文件都是如此的操作。
 
从特殊性来说,文件夹中保存着的是文章。从普遍性的意义来说,只要把文件夹的权限共享方式设置正确,那么这个文件夹可以保存任何形式的私有文件。那么在这里得到的理论之一:建立一个可以保存任何形式的私有共享的文件夹的方法是什么呢?
 
对于这个理论,继续的进行分析。用户、文件夹、权限、共享,这四个内容是对于所有操作抽象。也就是说场景中的内容,最终可以归结为上述四项内容的抽象。也即编程语言所说的类,类是没有实例化的对象。对象是具有具体属性数据的类。类与对象的区别在于属性而非方法。类中会有一些虚的方法,也即只有名称,没有行为的方法过程。继承的类,可以对这些父类中的虚的过程进行具体的行为操作。
 
数据文件服务器的行为,无外乎上述四种操作的组合。也即用户、文件夹、权限、共享基本的砖头,所有的功能都是这些砖头不同方式的组合。关系?要找出四种操作彼此之间的联系。无论其具体的表现形式是如何的,但是彼此之间的联系,具有一定的规则,这是不会改变的。这个规则在程序设计的时候就已经明确了。  
 
理性的认识就是要从实践活动中抽象掉千变万化的现象,找到静止不变的彼此之间的联系。也即是本质。本质是静止的不变的吗?在一定的条件下,这个条件是在这里是指软件的版本。软件的版本不变,这个软件中的四项内容,彼此之间的关系就不会改变。从这个意义上,本质是不变的,也即事物是处在量变的过程。
 
作者在私有文件夹中究竟是保存文章还是保存图片,对于文件夹的共享方式,用户权限没有任何的影响。保存文章或者保存图片又或者保存视频,用户、文件夹、权限、共享,这四项彼此关系并不发生改变。这就是本质,变化的只是保存文件的类型。也即是现象。从这个意义上来说本质是静止的,现象是变化的。
 
软件的版本变化了,用户、文件夹、权限、共享四项内容的关系也就可能发生改变,也可能不变。这个要通过实践来检验。从这个意义外说本质又是变化的。
 
文件服务器基本的四项内容:用户、文件夹、权限、共享。无论软件的版本怎么的变化,这四项内容是基本不变的,也即是点。变化了的是彼此之间的关系,但是内容是不变的。从这个意义上来说,内容比关系又更加的抽象,也即内容是本质,是不变的。彼此的关系反而是现象,是变化的。
 
理论脱离实践活动,也就没有任何的意义。从这点来说,理论性的文章必然有具体行业的,具体社会活动做为基础。从某一个行业形成的,某一个社会活动中的理论是不是会片面呢?
 
一方面理论是片面的,理论总有这个理论适用的范围。一方面理论是全面的,因为事物有共性。任何事物最初都是从无到有,生命的细胞是如此,天下万物也是如此。这就是中国古代哲学家发现的,天下万物生于有,有生于无。天下万物有其共性,那么由万物由生产出来的理论,必然也就有共性。人的认识具有普遍性的意义,这不奇怪。
 
理论性的文章,没有具体的实践活动,科学实验,没有了社会活动做基础。那就成了无源之水,无根之木。最后只能是不断的搬来倒去的堆彻一些哲学上的词语。在哲学里哲学,在理论里理论。哲学家们只是不断的解释世界,问题在于改造人们的现实生活。
 
这是一篇准备建立FreeNAS服务器时所想到的文章,要写一本用户手册,写一个说明书。结果写成了这样的内容。想到那就写到那里吧,想到什么就写些什么。文章看起来没有条理,天马行空,很是混乱。就是我自己也有这样的感觉。