保密等级:内部公开文档规范说明书XXX信息技术有限公司XXX Information Technology Co.,LTD.2020年3月文档修订历史目录1文档规范背景 (1)1.1文档规范目的 (1)1.2使用范围 (1)2文档内容 (2)3文档命名规范 (3)3.1命名规范意义 (3)3.2命名原则 (3)3.3文档命名结构 (3)3.3.1项目名称 (3)3.3.2文档名 (4)3.3.3部分名 (6)3.3.4日期 (6)3.3.5版本号 (7)3.3.6文档后缀 (7)3.4文档名举例 (8)4文档结构规范 (9)4.1页面设置 (9)4.2封面 (9)4.2.1文档标题 (9)4.2.2公司名 (10)4.2.3日期 (11)4.2.4保密等级 (11)4.3文档修订历史 (12)4.4目录 (13)4.5页眉页脚 (13)4.6标题样式 (13)4.7正文 (13)4.8文档属性 (13)5文档正文规范(建议) (14)5.1字体规范 (14)5.1.1正文 (14)5.1.2数字规范 (14)5.1.3英文规范 (14)5.2标题编号 (14)5.3段落 (15)5.4编号 (15)5.5图片格式 (16)5.6表格格式 (16)1文档规范背景1.1文档规范目的规范公司产品及技术文档体系,加强文档的标准化管理。
加强公司项目文档管理,便于项目人员阅读、修改和跟踪,采用标准化规范对文档进行统一命名,文档格式及要求标准化。
文档命名规范确保公司产品及技术部重要文档具有唯一编号,便于文档的有效识别、追溯和控制,保证部门文档体系有效运转。
对文档格式和内容制定规范,指导各部门各种文档编制工作,规范和统一文档风格有利于文档保持一致性,提高文档质量。
1.2使用范围本规范主要适用于项目的立项书、规划设计方案、建设方案、投标文件及需求分析文档、使用手册、技术开发文档等。
文档命名规范、文档结构规范强制执行,对于段落标题、文档正文规范本规范说明书只是建议。
对于招标文件或者客户对文档格式有规定的,文档格式按照要求撰写。
2文档内容文档规范包括文档命名规范、文档结构规范、文档正文规范。
文档命名规范包括文档命名的意义、原则和结构。
文档结构规范包括文档页面设置、封面、修订历史、目录、页眉页脚、标题编号、文档属性等规范。
文档正文规范包括文档正文、段落、编号、图表格式的建议。
3文档命名规范3.1命名规范意义1)让接收方一眼明白文档的主题。
2)方便快速检索到所需要的文档。
3)区分版本并随时回溯以前的版本。
3.2命名原则1)命名要有助于文档的排序,便于查找和管理。
2)命名要能看出文档的内容。
3)文档命名使用中文、英文字母和阿拉伯数字的组合4)文档名组合一般用“_”下划线、“()”圆括号、“.”点、“[]”六角括号这几种字符,其他字符一般不要使用。
3.3文档命名结构文档命名的结构:[客户名称]项目名称[子系统名称] + 文档名+(部分名)_日期_V版本号.文档后缀对于投标文件、招标文件、评审文件或者方案最后提交版后者发布版,可以去掉版本号,改为终稿、发布版或者打印稿[客户名称]项目名称[子系统名称] + 文档名+(部分名)_日期_终稿.文档后缀3.3.1项目名称如果同一项目有多个客户的或者项目名比较简单的,可以把客户名称(缩写)加在项目名称之前。
如果一个项目有多个子系统文档,可以加上子系统名称或者直接用子系统名称代替项目名称,或者项目名称用一个缩写代替。
如果是投标文件或者正式申报文件,把“项目”或者“建设项目”也补齐或者根据招标文件的项目全称来命名。
如果每年都有同样的项目,可以在项目名称上加上年份。
总之,项目名称不能太长,也不能太短,要能体现客户,项目内容,文档内容。
比如:1)电信电话会议系统扩容2)商贸公司第三方支付平台预付卡系统3)智慧校园统一消息推送应用平台服务项目4)信息终端技术迭代更新优化实施项目3.3.2文档名工程项目全周期包括了立项阶段、计划阶段、实施阶段和完成阶段。
产品及售前部门主要负责项目立项阶段的立项报告、需求调研、方案建议书。
计划阶段的招投标文档。
实施阶段的的需求分析文档、使用手册等。
技术研发部门主要负责技术设计、开发及测试文档的编写。
以下所列是工程项目全周期各阶段的文档名。
3.3.3部分名可选。
部分名用一对英文符号()标注(不要用中文的括号),主要是一个项目有几个文档组成的时候,对各部分组成进行标注。
比如投标文件,在项目名称及文档名称之后用部分名,部分名可以是:报价部分、技术部分、商务部分、商务技术标、开标一览表等标注不同的文档。
如果一个大型项目的科研报告分成几个文档也可以把背景资料、总体规划、详细设计、实施计划等内容分成几部分,在每个文档后面用部分名进行区分。
有些项目会重点突出项目的特殊性质及阶段性,也可以用部分名进行标注,比如试点、省立项、预审文件、第一次谈判等等。
3.3.4日期日期:yyyymmdd,yyyy:用四位数字表示公元年份,如2018表示公元2018年。
mm:用两位数字表示月份,不足两位时,第一位用零补齐,如03表示3月。
dd: 用两位数字表示日期,不足两位时,第一位用零补齐,如15表示第15号。
例如:20180901 表示2018年09月01日。
日期一般是提交文档的日期。
3.3.5版本号版本号以V(大写)开头,版本号为两位数字,包括主版本号和副版本号,中间用点隔开,如V1.0,V1.2,V2.0等。
对于没有重大修改的文档则每次修改在副版本号数字加1;当有多人同时提交同一版本的文档时,可以在版本标识的后面加入人名或缩写来区分。
比如V1.0(wax),V1.0(wj)等。
3.3.6文档后缀新建文档,建议使用Microsoft Office 2013及以上版本的办公软件。
没有特殊要求不要使用兼容模式。
兼容模式会损失一些格式。
3.4文档名举例XXX学校治安视频监控系统项目建设方案_20120706_v1.0.docxXXX大学城校区云时代智慧校园规划设计方案_20170404_V1.3.docxXXX地铁运营施工调度管理系统项目投标文件(商务部分)_20170711_V1.2.docxXXX增值业务平台综合服务系统总体设计_20170601_V1.4.docxXXX国际贸易“单一窗口”项目建设方案_20170302_V1.3.docxXXX轨道交通运营施工管理系统采购项目投标文件(商务技术标)_20170426_V1.0.docx XXX地铁施工调度系统项目投标文件(技术部分)_20170528_打印版.docxXXX建筑环境及能效监控系统结构体系研究申报文件_20151225_终稿.docxXXX企业信息化办公系统改造招标文件_发布版.docx4文档结构规范4.1页面设置所有文档除个别表格和图纸使用A3页面大小外,其余一律用A4页面大小。
页面一般为纵向,如需要可将部分正文设为横向。
Word页面原则上使用软件默认设置,即:上2.54cm,下2.54cm,页眉1.5cm,页脚1.75cm,左右为3.17cm,页码统一在下方居中。
为避免最后一页只是几行占一页的现象,可适当收缩行距,使文档大部分内容成为整页,但收缩行距不宜小于20磅。
4.2封面封面内容主要包括文档标题,公司名、日期三项内容封面没有页眉和页脚对于投标文件还包括正副本及技术商务标识、招标编号等,具体按照招标文件要求。
4.2.1文档标题文档标题:字体黑体、小初、居中文档规范说明书4.2.2 公司名公司名:人工输入公司名+LOGO ,或者直接美工图片,如有必要也可以带上公司地址。
方案一(推荐):XXX 信息技术有限公司XXX Information Technology Co.,LTD.方案三:XXX 信息技术有限公司XXX4.2.3日期日期:中文及阿拉伯数字都可以,宋体小三、居中。
如果是中文就全部使用中文,比如二〇一六年七月十日2018年7方案二:方案三:4.2.4保密等级保密等级:对于内部文档加上保密等级。
需要保密的文档密级从高到低分为“绝密”、“机密”、“秘密”“内部公开”和“公开”五级,具体定义如下:●绝密:涉及公司与客户或供应商,分销商所签订相关的文档资料。
仅限于公司最高管理层及各资料所涉及的经过相应管理人员授权的相关人员查阅。
●机密:公司内部所相关的规章制度及技术规范,开发手册等;还有各项目开发文档、管理文档及产品等仅供相关部门高级领导以及经过授权后相关人员查阅。
●秘密:需交付用户或与客户进行交流的文档与产品,可供相关项目客户查阅。
●内部公开:内部不限制,公司内部可以以任何形式获得文档的信息并阅读、保存、修改后自用等等,但是不允许向外传播的文件。
●公开:可以对外公开或发布的文件。
4.3文档修订历史文档修订历史内容建议包括:序号、版本号、修改内容、修改日期、作者(修改人)、审核人等,如下表所示,可以根据实际情况添加内容。
修订页中的版本和作者要与封面的版本和编制一致。
关于版本号说明:●文档审核之后,正式发布的第一个文档版本号为1.0;之后所有审核之后的版本按顺序(全部取整,如2.0、3.0)编排版本号。
●对于没有审核的文档,从原有文档副版本号 + 0.1开始按顺序编号,可以由作者自行编号。
●如果只是修改一些错误,内容没有实质性变化,版本号可以不变,只是修改日期。
4.4目录首页单独成页,不设置页码。
修订历史与目录单独成页,页码单独设置为罗马数字I,II,III,目录采用超链接直接生成(或者选中模板目录内容,点右键选“更新域”),采用宋体、小四号字。
一般采用三级目录,动态更新目录,任何编号栏目修改都要及时更新。
对于大型技术方案或者投标文件有根据需要也可以采用四级目录。
4.5页眉页脚页眉左边为项目名称,右边为文档名称页脚居中添加页码,页码可以是普通数字,也可以是第n页共N页,页脚字体Times New Roman,小五号字体。
4.6标题样式文档中的同级标题样式要一致,一般情况下最少有三级标题,多的可以有六级标题。
4.7正文正文一般采用宋体,小四,对于篇幅比较长的技术方案,可以调整为宋体、五号。
正文行距一般情况下1.5倍行距。
段前、段后均为0行。
具体公式、图表根据需要排版。
4.8文档属性文档属性包括标题、主题、作者、上次修改者,单位。
一般情况下这些属性可以不修改,如果特殊文档,需要隐藏这些信息的,建议修改这些信息,作者统一修改成Admin,标题修改成文档名。
单位修改成科技公司。
5文档正文规范(建议)5.1字体规范5.1.1正文正文:宋体,小四号字体,内容较多情况下可以为五号字体。
字形:除特殊说明之处,字形一般为常规。
字体颜色:黑色。
需要特别强调或区分的内容可采用其他颜色,但建议一篇文档中不使用超过三种字体颜色。