产品软件及用户指导类手册版本编号规则
- 格式:docx
- 大小:21.87 KB
- 文档页数:3
软件产品用户手册编写指导规范一、引言软件产品用户手册是为了帮助用户快速了解和使用软件产品而编写的重要文档。
良好的用户手册能够使用户轻松上手,减少用户对技术支持的需求,提升用户满意度。
本文将从整体结构、语言规范、内容要点等方面为编写软件产品用户手册提供指导规范。
二、整体结构1. 标题页在用户手册的开头添加标题页,包括软件名称、版本号、日期和版权信息,以便用户准确标识和识别。
2. 目录为了方便用户查找和快速定位所需信息,编写用户手册时应包含详细的目录,并准确标识每个章节的页码。
3. 简介简介部分应包括软件产品的背景介绍、主要特点和功能以及适用范围等内容,帮助用户快速了解软件产品的概况。
4. 安装与配置在此部分中,需要提供清晰、详细的安装步骤和配置指导,包括软件的系统要求、安装前准备、安装步骤、常见问题解答等相关信息。
5. 使用说明使用说明是用户手册的核心内容,需要通过简洁明了的语言,逐步介绍软件的使用方法、操作步骤和功能说明。
可以结合图文并茂的方式,提供示意图和操作界面截图,以便用户更好地理解和使用。
6. 常见问题与故障排除在用户手册中添加常见问题与故障排除的章节,列举常见问题及解决方法,帮助用户自行排查故障和解决常见问题。
7. 版权和免责声明在用户手册的结尾部分,添加版权和免责声明,明确软件产品的知识产权归属和免责条款,保护软件开发方的合法权益。
三、语言规范1. 使用简洁明了的语言用户手册的语言应尽量简洁明了,避免使用过于专业的术语或太过晦涩的词汇,保持与用户的沟通顺畅。
2. 避免歧义和模棱两可的表述用户手册应尽量避免歧义和模棱两可的表述,确保用户可以准确理解,正确操作软件。
3. 使用一致的术语和格式为了用户能够更好地理解和识别,用户手册中所使用的术语和格式应保持一致,避免混淆和困惑。
四、内容要点1. 首次使用向导提供软件产品的首次使用向导,引导用户进行软件的首次安装和初始化设置。
2. 主要功能说明逐一介绍软件产品的主要功能和使用方法,包括核心模块、操作界面、常用功能操作等。
一、产品编码生成规则软件产品编码=产品分类+专业类别+专业+产品流水号+语言+产品属性+产品属性流水号资源产品编码分为父编码和子编码,父编码同软件产品编码,子编码如下:资源产品子编码=产品分类+专业类别+专业+产品流水号+语言+产品属性+产品属性流水号+资源类型产品流水号:指每个产品的编号,编号规则取决于同一专业录入系统的顺序。
产品属性流水号:➢标准产品的产品属性流水号固定为00➢定制产品的产品属性流水号依次为01,02,03……➢DEMO产品的产品属性流水号固定为90➢代理产品的产品属性流水号固定为91➢外购产品的产品属性流水号固定为92➢合作开发产品的产品属性流水号固定为93资源类型说明:✧2D动画 DA✧3D动画 DB✧微课 SA✧宣传片 SB✧课堂实录SC✧课程标准WA✧教学设计WB✧教学大纲WC✧教学课件WD✧教学案例WE✧习题作业WF✧电子教材WG✧试题试卷WH✧教案WI✧实训手册WJ✧实训指导书WK✧教师手册WL✧学生手册WM✧其他文档资源WN✧图片TA●标准产品如国泰安导游全景模拟实训平台软件、国泰安导游英语情景教学实训系统软件、国泰安导游考试系统软件这三款软件的产品编码。
产品分类为软件SD,专业类别为旅游类TR,专业为旅游管理TM,产品流水号分别为001,002,003,语言为中文简体SC,产品属性为标准US,则产品编码依次为SD-TRTM-001-SC-US-00,SD-TRTM-002-SC-US-00,SD-TRTM-003-SC-US-00。
●定制产品如国泰安智慧校园易管理平台软件产品编码:SD-INEM-001-SC-US-00其定制产品有:①开封文化旅游智慧校园易管理平台软件产品编码:SD-INEM-001-SC-UC-01②湖南石油智慧校园易管理平台软件产品编码:SD-INEM-001-SC-UC-02●DEMO(演示产品、预研产品)国泰安ZSpace平台VR产品体验包产品编码:SD-DEDE-001-SC-UD-90●代理产品NewtonsPark产品编码:SD-ABCD-001-EN-UA-91●外购产品YYYY产品编码:SD-ABCD-001-SC-UP-92●合作开发产品XXXX产品编码:SD-ABCD-001-SC-UT-93●资源类产品XXXX父编码:RS-ABCD-001-SC-US-00子编码:动画:RS-ABCD-001-SC-US-00-DA微课:RS-ABCD-001-SC-US-00-SA单独宣传片类的素材:RM-ABCD-002-SC-US-00-SB二、产品编码用途因产品编码是产品的身份证件,则可通过产品编码搜索某一产品有多少版本,有多少个衍生产品(定制产品、DEMO、合作开发等)。
erp电气产品编号规则
ERP电气产品编号规则主要涉及以下几个方面:
1. 基础信息:这部分通常包括产品名称、规格、型号等信息,用于描述产品的基本属性。
2. 规格参数:这部分通常包括产品的电气参数、机械参数、环境参数等,用于描述产品的具体规格和性能指标。
3. 生产信息:这部分通常包括生产厂家、生产日期、生产批次等信息,用于追踪产品的生产过程和质量控制。
4. 特殊标识:这部分通常包括产品的特殊标识,如安全标识、环保标识等,用于标识产品的特殊属性和要求。
具体来说,ERP电气产品编号规则可以根据不同企业的实际情况和需要进行制定,但通常应遵循以下原则:
1. 唯一性:编号必须是唯一的,不能出现重复的情况。
2. 规范性:编号的格式和组成应规范、统一,方便识别和记忆。
3. 可读性:编号应具有可读性,能够清晰地表达出产品的属性和信息。
4. 可扩展性:编号应具有一定的可扩展性,能够适应企业未来的发展和产品变化。
总之,ERP电气产品编号规则是用于规范和管理企业产品的编号方式,有助于提高企业的生产效率和管理水平。
软件研发版本管理规定 HEN system office room 【HEN16H-HENS2AHENS8Q8-HENH1688】软件版本管理制度1.引言目的本文档是为规范软件研发版本管理而制定的。
范围本文档为各产品部、事业部版本管理员提供有关版本管理规范的相关内容,包括:版本标识方法软件系统数据的存放文档的修改控制文档的备份制度术语定义SVNSvn是一个开源的版本控制系统Subversion的简称文档一种数据媒体和其上所记录的数据。
配置管理标识和确定系统中配置项的过程,在系统整个生存周期内控制这些项的投放和更动,记录并报告配置的状态和更动要求,验证配置项的完整性和正确性。
软件配置软件的具体形态在某时刻的瞬时影像。
配置项软件配置管理的对象称为配置项,如:系统规格说明书,项目开发计划,用户手册,源码。
基线软件生存周期中各开发阶段末尾的标记,它的作用是把各阶段工作的划分更加明确化,使本来连续的工作在这些点上断开,使之便于检验和肯定阶段成果。
版序控制记录版本更新记录2.版本管理2.1版本标识方法为了使工作规范化、统一化,各项目组实行的版本标识管理方法分为:正式版本和特殊版本。
2.1.1正式版本公司在市场上发行的正规版本。
以“V”开头,版本号放后。
V前面增加项目名称,版本号分3节:主版本号,次版本号和内部版本号,每节之间以小数点(.)间隔。
如V2.0.12.2目录结构由于各项目组的实际情况不同,目录结构很难统一,但为了能更好地管理各项目组的文档,建议可将被管理的配置项分为三大类:文档类、源码类及安装盘类,这样存放比较清晰,有利于版本管理。
至于二级目录是以版本划分,并根据制定的目录结构给出文件级目录清单(先给出源程序及文档的文件级目录清单,安装盘的可以后再执行):。
现以农电平台的目录结构举例如下:(1)正始版本:以“V”开头,版本号放后,主版本号和次主版本号之间的“.”去掉,明细版本号之前加“-”。
举例如下:版本号目录名V1.0.1 1.1.2 文档的存放2.3.1 当前版本和历史版本的存放对于源码文件,特别增加了一个Current目录,存放当前正在开发与维护的源码文件,当前未发布版本的所有数据都存放在.....\CURRENT\下。
产品软件及用户指导类手册版本编号规则在软件开发和用户指导文档编写中,版本编号的规则起到了重要的作用。
准确的版本编号可以方便开发团队和用户及时了解软件的更新和改进内容。
本文将介绍一种常见的产品软件及用户指导类手册版本编号规则,以帮助开发团队统一版本管理和用户方便使用。
一、版本编号的概念和重要性版本编号是指为标识软件或文档的不同版本而进行的编码命名。
每个版本都会有特定的改进、修复或新增功能,因此为每个版本分配唯一的编号是必要的。
版本编号的正确定义和使用可以帮助团队成员和用户准确地识别和使用最新的软件版本。
二、版本编号的组成方式在本规则中,我们采用主版本号(Major Version Number)、次版本号(Minor Version Number)和修订号(Revision Number)的组合方式,形成一个标识版本的编号。
具体如下所示:主版本号.次版本号.修订号1. 主版本号(Major Version Number):指的是软件或用户指导文档的重大更新或重大改变。
当软件或文档发生较大规模的改进时,主版本号应进行加一操作。
2. 次版本号(Minor Version Number):指软件或用户指导文档的较小更新或改进。
当软件或文档发生较小范围的改进时,次版本号应加一。
3. 修订号(Revision Number):指对软件或用户指导文档进行的错误修复、调整或其他较小的修改操作。
每次修订后,修订号应加一。
三、版本编号的使用示例以一个虚拟的软件 "ABC软件" 为例,我们采用上述版本编号规则进行标识。
初始版本为:1.0.01. 当 ABC 软件进行了全面升级和重大改进后,改动较大,此时主版本号加一:2.0.02. 紧接着进行了一些较小的功能调整和修订,次版本号加一:2.1.03. 后续进行了一些错误修复和细微调整,修订号加一:2.1.14. 又进行了一些功能优化和细节修正,修订号加一:2.1.2在用户指导文档方面,找到与软件版本相对应的用户指导类手册版本号,以便用户能够获取正确的文档。
引言1 目的一项计算机软件的筹划、研制及实现,构成一个软件开发项目。
一个软件开发项目的进行,一般需要在人力和自动化资源等方面作重大的投资。
为了保证项目开发的成功,最经济地花费这些投资,并且便于运行和维护,在开发工作的每一阶段,都需要编制二定的文件。
这些文件连同计算机程序及数据一起,构成为计算机软件。
文件是计算机软件中不可缺少的组成部分,它的作用是:a.作为开发人员在一定阶段内的工作成果和结束标志;b.向管理人员提供软件开发过程中的进展和情况,把软件开发过程中的一些“不可见的”事物转换成“可见的”文字资料。
以便管理人员在各个阶段检查开发计划的实施进展,使之能够判断原定目标是否已达到,还将继续耗用资源的种类和数量;C.记录开发过程中的技术信息,便于协调以后的软件开发、使用和修改;d.提供对软件的有关运行、维护和培训的信息,便于管理人员、开发人员、操作人员和用户之间相互了解彼此的工作;e.向潜在用户报导软件的功能和性能,使他们能判定该软件能否服务于自己的需要。
换言之,本指南认为:文件的编制必须适应计算机软件整个生存周期的需要。
计算机软件所包含的文件有两类:一类是开发过程中填写的各种图表,可称之为工作表格;另一类则是应编制的技术资料或技术管理资料,可称之为文件。
本指南规定软件文件的编制形式,并提供对这些规定的解释。
本指南的目的是使得所编制的软件文件确实能够起到软件文件应该发挥的作用。
2 范围本指南是一份指导性文件。
本指甫建议,在一项计算机软件的开发过程中,一般地说,应该产生十四种文件。
这十四种文件是:可行性研究报告;项目开发计划;软件需求说明书;数据要求说明书;概要设计说明书;详细设计说明书;数据库设计说明书;用户手册;操作手册;模块开发卷宗;测试计划;测试分析报告;开发进度月报;项目开发总结报告。
本指南将给出开发过程中建议产生的这十四种文件的编制指导,同时,本指南也是这十四种文件的编写质量的检验准则。
1.0目的为了规范管理本公司的各种文件和记录,对其编号方法做出统一规定。
2.0适用范围适用于公司的所有文件与记录。
3.0内容3.1文件的编制格式3.1.1文件编制时,正文部分都要加上文件头用来明示文件信息,文件类别的填写请按照后附《文件类别对照表》中的文件类别进行填写,文件头中的具体设置参照附件。
(文件模板可以在OA系统的“模板”文件夹中下载使用。
)3.1.2文件编写条目按照以下格式。
1.01.11.1.11.1.1.12.0依此类推,层次分级最多不超过4级。
3.1.3文件页边距设置如下:竖版:上 1.8cm 下 1.5cm 左2.5cm 右1.8cm横版:上2.5cm 下1.8cm 左1.8cm 右1.5cm3.1.4文件正文字体为仿宋或宋体,字号13号,行间距为固定值20磅,数字序列字体为Arial,字号与正文相同,小标题可以加粗。
3.1.5文件文档为word文件,表单不限。
3.1.6页眉:1.5cm页脚:1.0cm页眉页脚及其他部分的未尽事宜以附件范本为准。
3.2表格记录的编制格式3.2.1表格编制时,要加入公司标示,公司标示如下图。
图(1)集团公司logo标示公司所有下发的公文,logo图标均用带字母标识的,文件头模板可以在OA导航系统中下载3.2.2表格具体排版样式参照附件的样本设置。
3.2.3表格中所有字体均为仿宋或宋体,表头字号为16号,表格正文字号13号,表格编号及表格正文之外的附属信息字号均为10号。
3.3文件的编号3.3.1公司、分厂及部门代码(详见附件)体系文件包含ISO9001质量体系文件,OHSAS18001安全体系文件,ISO14001环境体系文件。
3.3.2.1一阶文件(质量手册、安全手册、环境手册)X1-X2-01流水号:01—99文件类型标示: QM质量手册SM安全手册EM环境手册公司代码:参照附件说明:质量手册以后将分为集团公司质量手册和分公司质量手册,分公司质量手册的部分内容可引用集团公司质量手册。
1.总则软件产品的用户手册是软件产品开发的重要结果,也是用户学习使用软件产品的主要工具。
因此用户手册作为软件产品的组成部分,应当及时完成,并且能全面、详细地说明软件产品的功能、使用方法以及其它用户为使用、维护软件产品需知晓的事项。
2.目的对用户手册的编写时机、职责、内容及格式要求作出规定,以保证用户手册能满足用户正确使用软件产品的要求。
3.职责3.1.需求分析小组与项目组是用户手册的编写责任者;3.2.支持经理是用户手册编写的组织者;3.3.方正系统公司培训部负责用户手册的审核和印制。
4.工作程序4.1.用户手册的编写时机用户手册的编写应当从需求分析阶段开始进行。
在需求分析小组编写出需求规格说明书的同时,应完成用户手册的初稿。
该初稿应包括软件产品主要的功能描述以及界面描述。
在设计和实现(编码)阶段,项目组应随着软件产品的逐步细化以及变更的情况,同步完成用户手册的修改和细化。
当软件产品在项目组内完成集成测试时,用户手册的编写工作应基本完成,即此时用户手册的内容部分除因系统测试中发现错误而需进行部分改动外,不需要在内容方面进行增加。
但手册的格式可以暂时达不到要求。
软件产品提交系统测试时,用户手册达不到以上要求的,测试部门将不受理其测试申请。
4.2.用户手册的审定用户手册内容的审定,由项目组支持经理负责,同时应征求开发中心项目负责人的意见。
用户手册形式的审核由测试部门负责。
4.3.用户手册编写工作的组织在项目组建立后,用户手册的编写工作由支持经理负责组织。
具体的编写工作可以由项目组的成员共同完成,但支持经理负责用户手册编写工作的组织以及监督检查,并对其质量负责。
4.4.用户手册编写的格式要求见《方正用户手册排版要求》4.5.用户手册的内容要求4.5.1.封面用户手册的封面应包括以下内容:软件产品的名称、版本号以及版权单位信息。
其中软件产品的名称须使用软件产品的正式名称,并可以注明其简称。
版本号是指本次一同发行的软件产品的版本号而不是指手册的版本号。
用户手册编制规范版权声明《用户手册编制规范》的版权归XXX软件公司所有。
未经XXX软件公司的书面准许,不得将本规范的任何部分以任何形式、采用任何手段(电子的或机械的,包括照相复制或录制)、或为任何目的,进行复制或扩散。
(c)Copyright 2000 XXX软件公司。
版权所有,翻制必究。
是XXX软件公司的注册商标。
Microsoft、word是Microsoft Corporation的注册商标。
Windows是Microsoft Corporation的商标。
i前言用户手册对于任何产品都是不可缺少的组成部分。
一个好的产品没有一份完备的用户手册,也不能算作一个完备的产品。
对于软件产品来说更是如此,没有用户手册的软件不能算产品,没有好的用户手册,就不可能算好产品。
也就是说,一个好的软件产品除了具备与市场对路的思想、良好的用户界面、完备的测试之外,还必须有一本适合用户使用的用户手册。
本规范手册不仅指明了软件用户手册的内容,而且规定了XXX软件公司软件用户手册的统一版面、格式。
本规范手册就是按本规定编写的,但由于本规范手册内容的局限性,很难以样本的形式表现软件用户手册中可能出现的各种情况,所以请大家认真阅读本规范手册的内容。
我们希望XXX软件公司的相关人员,能够按照本规范手册编写自己的软件用户手册,做好我们的软件产品化工作。
由于时间仓促,编者水平有限,希望大家能够提出宝贵意见,以逐步完善本规范手册的内容。
i阅读指南〖手册目标〗本手册主要对XXX软件公司软件产品的用户手册所应包含的内容及版面格式作一个初步的统一规定。
由于实际情况千变万化,本规定很难一次做到面面俱到,需要逐渐完善。
〖阅读对象〗本手册是为XXX软件公司的所有软件开发人员和软件用户手册编写人员所编写的。
由于本手册中的格式规定部分是根据Microsoft Windows 下的Word 的功能而编写的,所以XXX软件公司的软件用户手册应该使用MicroSoft Word排版。
计算机软件产品开发文件编制指南在计算机软件产品的开发过程中,文件的编制是必不可少的一项工作。
这些文件记录了产品的设计、开发、测试、发布等各个阶段的重要信息,对于产品的质量和后续维护都有着至关重要的作用。
为了规范和统一文件编制标准,下面将介绍计算机软件产品开发文件的编制指南。
一、产品立项在软件开发项目启动之前,需要对产品的需求和可行性进行评估,确定产品的主要功能和开发目标。
在此阶段,需要编制的文件主要包括:1. 需求分析报告需求分析是软件开发的基础,是保证软件质量的关键环节。
通过需求分析,可以明确产品应该具备哪些功能,并对这些功能进行详细而准确的描述。
需要在报告中包含以下内容:•产品概述:简要说明产品的功能和主要特性。
•需求分析:详细描述产品的功能需求,包括用户需求、系统需求、数据需求、测试需求等。
•产品架构:阐述软件系统的整体结构和模块划分,并给出相应的流程图、类图等。
2. 可行性分析报告可行性分析是在需求分析的基础上,通过分析技术实现、市场需求、成本效益等方面的因素,评估软件产品开发是否可行的过程。
需要在报告中包含以下内容:•技术可行性分析:对所需技术是否存在、技术难度、可行性进行分析。
•市场可行性分析:对市场需求、市场竞争状况、产品定位和市场推广策略等方面进行分析。
•经济可行性分析:对软件开发成本、运维成本、盈利预测等方面进行分析。
二、产品设计在产品立项完成之后,需要进行产品的详细设计工作,规划产品的整体框架和各个模块。
在此阶段,需要编制的文件主要包括:1. 系统设计文档系统设计文档描述了软件系统的总体结构、各个模块的功能和实现方法,为程序员进行编码提供了依据。
需要在文档中包含以下内容:•系统概述:对软件系统的整体结构和功能进行简要概述,同时介绍软件系统的逻辑流程和处理方式。
•功能模块设计:对各个模块的主要功能进行详细介绍,包括模块的作用、输入输出、主要流程和算法等。
•接口设计:系统各个模块之间的接口包括参数传递、输入输出、函数调用等进行详细的设计说明。
XXXX(苏州)股份有限公司PLM技术文件编码规范XXXX-XXX-750-003编制:审核:批准:2021年01月1 目的为适应PLM上线的需求,产品在开发阶段的所输出的文档,便于文档的记录与存储,特制定此编码规则。
2 适用范围适用于技术中心在各产品开发阶段的技术文件编码。
3 职责本文件起草人负责后续的修订事项。
各部门主管负责审核本部门技术文件编码的正确性与唯一性。
技术中心文档管理人员负责监督技术文件的编码是否按此程序执行。
4 文件分类文件编码取其英文的简称。
4.1 管理类文件(MF)管理类文件(Management File)是指在经营管理过程中预先制定的书面要求,以人、事、物为对象;包括:流程文件、管理标准文件等。
4.2 指导类文件(GD)指导类文件(Guidance Document)是指在经营过程中,按照管理类文件的要求输出的文件,操作人员可以按照此文件进行相关性工作,如:项目任务书、产品测试计划书、操作说明书、SOP、产品说明书、操作说明书、产品规格书、技术规格书、物料规格书等4.3 图纸文件(DW)图纸文件(Drawing)是指自主研发产品机械总装图、机械零件图、产品效果图、电子设计图、PCB 丝印图、原理图等。
4.4 表单文件(FM)表单文件(Form)是指反映实际生产经营活动中执行标准的情况及结果;如:项目需求单、调研报告、评审单等。
4.5 外来文件(ED)外来文件(External Document )是指开发阶段,按照国际、国标、地方、行业及企业颁布的技术标准文件输出记录文件;包括检测/认证报告、专利等。
其中,检测/认证报告包括ROHS 、MSDS 、CE 、UL 、UN 等。
4.6 标准(SD )国标、国家和行业的标准(Standardization )、国家和地方的法律法规、适用法规和标准,顾客提供的工程规范等,被本公司收集引用的文件。
4.7 其他在PLM 操作过程中,对某任务操作进行一次记录,或是发起某种请求,该动作不输出任何文件信息,:如物料申请、BOM 变更、文档变更等。
产品版本管理规定一、制订本规定的目的促进软件产品开发、发布和维护过程的规范化,提高对外销售产品和项目的质量和服务的水平。
二、适用范围凡公司开发的项目和产品均适用本规定。
三、版本标识规则软件版本号是软件项目、产品在其整个生命周期内某一确定状态的唯一标识,由产品管理员统一管理。
软件产品版本号的启用、变更、终结等活动必须文档化,并具可追溯性。
软件项目、产品的所有组成内容,如程序、设计文档、测试文档等均应标明软件版本号(开发及测试人员的工作文档中也应注明相应的版本号。
(一)软件产品版本号编号规则主系统中文名称[+_子系统中文名称] +Va.b[.c]1、其中a为主版本号,初始号码为1,一般在下列情况下变化,变更时每次加1。
1.1 对系统的体系结构或总体设计进行了较大调整或改进。
1.2 增加了较多的系统功能、特性。
1.3 对系统的主要功能、特性进行了较大改进。
1.4 由公司主管领导批准。
2、其中b为子版本号,由两位数字组成,初始编号为00,一般在下列情况下变化,变更时每次加1。
2.1 对系统功能、特性进行了一定量的改进或调整。
2.2 对软件产品的一组错误或较严重错误而进行了一定量的修改。
2.3主版本号改变时,子版本号改变为起始编号。
2.4 由产品管理员提出并会同公司三人小组及市场部共同确定是否进行变化升级,并报主管领导批准后执行。
3、其中c为特殊版本号,只能用于由于特殊功能、要求或特殊使用方式对产品功能特性某些方面进行变更而形成适合某一特殊用途的软件版本的情况,如专版。
由产品管理员提出并会同公司三人小组及市场部共同确定。
无特殊版本时本项为空白。
(二)补丁程序编号规则软件产品交付后,对于产品的部分功能或子模块进行了修改,或在原产品的基础上新增部分功能模块,以及软件错误和缺陷的改正所产生的对系统临时进行的一些修补程序(或子产品)称为补丁程序(PTF)。
补丁程序的发布形式:以补丁包的形式发布。
补丁程序编号为:[补丁包名] +_PTF_YYMMDD(三)项目、产品开发和测试阶段软件程序的版本标定以按照上述规则产生的软件版本号为基础,通过增加日期后缀的方式进行临时标定。
项目文档命名规则编制:日期:____/____/____ 审核:日期:____/____/____ 批准:日期:____/____/____XXXX公司二零一五年五月制历史记录目录1 目的 (5)2 适用范围 (5)3 术语和缩略词 (5)4 规程 (5)4.1 文档命名规则 (5)4.2 配置项的版本标识 (12)4.3 标签的命名 (13)1 目的本文的目的是定义各项目所有相关文档和CMM要求的过程文件的格式和规则,以及配置管理中对配置项和版本的标识。
2 适用范围本规则适用于所有需求、设计等文档和过程文件。
3 术语和缩略词无4 规程4.1 文档命名规则1组织标准软件过程文档编号(1)过程文件格式:XXX-P-××,初始编号为:XXX-P-01,最大编号为:XXX-P-99。
(2)指南文件编号:XXX-G-××××,前两位××为指南所对应的过程文件编号。
(3)模板文件编号:XXX-T-××××,前两位××为指南所对应的过程文件编号。
2产品命名规范(1)中文命名规范:中文全称V产品版本号。
英文命名规范:首字母大写V产品版本号。
3项目文档编号(1)编号规则分三种:1)单个文档:首字母大写V产品版本号-阶段英文缩写-文档名称英文缩写。
2)多个子文档:首字母大写V产品版本号-阶段英文缩写-文档名称英文缩写—流水号。
3)周期性:首字母大写V产品版本号-文档名称/英文名称-八位日期。
(2)项目阶段及文档名称英文缩写,见下表:4文档版本(1)格式:V×××.×××,初始版本号为V0.1,最大版本号为:V999.999。
其中,草稿状态的版本均为V0.×××,例如:V0.1,V0.2……V0.999;而经过评审通过的文档版本均从V1.0开始,例如:V1.0,V1.1,V2.0等。
结构版本号规则版本号是用来标识软件或产品的不同版本的一种标识符。
它由多个数字组成,数字之间使用点号(.)分隔。
每个数字代表一个特定的含义,用于表示软件或产品的变化和更新。
版本号规则是一种约定俗成的规则,为了方便用户理解和使用,遵循一定的规范。
版本号一般由三个部分组成,分别是主版本号、次版本号和修订号。
主版本号表示软件或产品的重大更新或改进,当主版本号发生变化时,通常意味着软件或产品的功能、界面或架构发生了较大的变化。
次版本号表示软件或产品的一些功能增加或改进,当次版本号发生变化时,通常意味着软件或产品新增了一些功能或对现有功能进行了改进。
修订号表示软件或产品的一些问题修复或bug修复,当修订号发生变化时,通常意味着软件或产品修复了一些已知的问题或bug。
除了主版本号、次版本号和修订号之外,版本号还可以包含其他部分,如预发布版本号、构建号等。
预发布版本号表示软件或产品的测试版本或开发版本,通常用于内部测试或公开测试,当预发布版本号发生变化时,通常意味着软件或产品的功能还在开发或测试中,并不稳定或完善。
构建号表示软件或产品的具体构建或编译版本,用于区分不同的构建版本,当构建号发生变化时,通常意味着软件或产品的代码或配置发生了变化。
版本号规则可以根据需求和约定进行灵活定制,不同的软件或产品可能采用不同的版本号规则。
一般来说,版本号应遵循以下原则:1. 版本号应具有可读性和易理解性,以便用户能够快速了解软件或产品的变化和更新。
2. 版本号应具有一定的顺序性和递增性,以便用户能够识别出新版本和旧版本之间的差异。
3. 版本号应具有一定的一致性和规范性,以便用户能够准确地比较和判断不同版本之间的差异和兼容性。
4. 版本号应避免重复和冲突,以免给用户带来困惑和误解。
版本号规则是一种标识软件或产品不同版本的约定规则,它能够方便用户了解和使用软件或产品,同时也能够帮助开发者管理和维护软件或产品的版本。
版本号规则应符合一定的原则和约定,以便用户能够准确地识别和比较不同版本之间的差异和兼容性。
×× -C-(BZ)-1-0质量管理体系文件编号规定和标识规则一、一级文件(质量手册)编号规定质量手册编号由三部分组成:第一部分:公司英文简写,即XX第二部分:文件级别。
质量手册的文件级别用 A 表示。
第三部分:版本号。
版本号从0 开始,第一次修改变为1,第二次修改变为2,依此类推。
举例:质量手册XX–A–0英文简写版本号二、二级文件(程序文件)编号规定程序文件编号由四部分组成:第一部分:公司英文简写,即XX。
第二部分:文件级别。
程序文件的文件级别用 B 表示。
第三部分:流水号。
用1、 2、 3,, 依次排序。
第四部分:版本号。
版本号从0 开始,第一次修改变为1,第二次修改变为2,依此类推。
举例:程序文件版本号XX–B–1-0英文简写流水号三、三级文件编号规定三级文件编号由五部分组成:第一部分:公司英文简写,即XX。
第二部分:文件级别。
三级文件的文件级别用 C 表示。
第三部分:文件类别。
三级文件包括:工作依据、作业指导书、岗位职责。
a)工作依据类型:“法规”表示为“FG”“规章”表示为“GZ”“公司内部制度”表示为“ZD”(意为“制度”)“其他文件”表示为“QT”(意为“其他”)b)作业指导书作业指导书按用途分类,可分为:规范类、指南类、标准类、综合类。
“规范”用“GF”表示“指南”用“ZN”表示“标准”用“BZ”表示c)岗位职责用“ZZ”表示第四部分:流水号。
用1、 2、 3,, 依次排序。
第五部分:版本号。
版本号从0 开始,第一次修改变为1,第二次修改变为2,依此类推。
举例:三级文件流水号XX–C –(LB)–1 –0英文简写文件类别版本号四、四级文件编号规则四级文件编号由五部分组成(每部分中间以“- ”连接):第一部分:公司英文简写,即XX第二部分:文件级别。
四级文件的文件级别用 D 表示。
第三部分:四级文件类型四级文件类型由三部分组成:用途+使用范围a)按用途分类,可分为:注册类、临床类、服务类、检查类、调查类、综合类、其他类。
产品软件及用户指导类手册
版本编号规则
1 适用范围
本规则适用于SP8200产品线发起并维护的所有产品软件及用户指导类手册。
具体包括:
2 规则
2.1 通用规则:
a)版本编号前缀为“V”(大写);
b)版本编号一般由多项数字位组成,数字间以“.”符号分隔;
c)特定情况下,最后一位数字末尾后还将添加一位字母位(小写),数字与字母间不
添加任何分隔符;
【举例】V4.0.1.1版本、V3.3.1.4a版本
d)每项数字位均从0开始递增使用,字母位从a开始递增使用。
在前项数字变化时,
其后所有数字/字母位全部清零。
【举例】V4系列第一个版本编号是V4.0.0.0
2.2 软件版本编号规则:
a)软件版本编号仅对系统整体软件进行,不针对子软件(各部分子软件以SVN号标
记);
b)软件版本号包含4位数字位,每位数字含义如下:
i.第一位表示系统硬件形态的变化;
ii.第二位表示系统软件功能(不含测试例)的变化;
iii.第三位表示测试例支持情况的变化;
iv.第四位表示版本迭代修正情况;
c)软件版本号末尾可以包含1位字母位,用于版本发布后意外发现重大问题并仅针
对该问题进行修正后的补丁版本编号;
2.3 产品简介、数据手册版本编号规则:
a)产品简介、数据手册版本号均包含3位数字位,数字位含义与软件版本号前3位
数字完全一致;
b)产品简介、数据手册版本号数字位必须与对应的产品软件版本号的前3位保持一
致;
c)产品简介、数据手册版本号可以包含1位字母位,用于文档发布后意外发现重大
问题并仅针对该问题进行修改后的补丁版本编号;
【举例】V4.0.1.2版本作为正式对外发布的版本,包含《SP8200 LTE终端RRM一致性测试系统数据手册》V4.0.1
2.4 用户手册、系统校准手册版本编号规则:
a)用户手册、系统校准手册版本号均包含2位数字位,数字位含义与软件版本号前2
位数字完全一致;
b)用户手册、系统校准手册版本号数字位必须与对应的产品软件版本号的前2位保
持一致;
c)用户手册、系统校准手册版本号可以包含1位字母位,用于文档发布后意外发现
重大问题并仅针对该问题进行修改后的补丁版本编号;
【举例】V4.0.1.2版本作为正式对外发布的版本,包含《SP8200 LTE终端RRM一致性测试系统用户手册》V4.0
[完]。