技术文档怎么写
1.如何写好技术文档
写好文档,注意点有: 一、思路清晰、章节分布合理 分章节、逐层深入地描述问题。
这是写科技文档的要旨。看看MSDN和各家软件公司的产品文档就可以知道,无一不是如此。
二、不用口语 科技说明文档,不用口语。不能出现“你们”、“我们”、“好啊”、“咋样啊”、“应该”。
这些都不能出现。
比如,“应该”应写成“应”、“需”等书面用语。一些讨论稿可以适量使用口语。
文档代表公司和技术要点,不是体现个人魅力的地方。一个公司不能使用五花八门风格的文档。
口语的使用,更是会雪上加霜。 三、形成固定风格 科技文档不要求风格各异,但求达意简约。
这个和写文章的方法是格格不入。 可以针对每类事务,形成固定的模板。
所谓有章可循。要把它形成组织积累。
而不是个人行为。这样能形成整体风格。
四、站在读者的角度写 主要涉及到难度、叙述方式等。文档叙述的难易程度要和读者匹配。
否则, 难了看不懂。太简单了,也没有意思。
这些都没有起到效果。 五、解决问题是核心 任何文档写出来都是要解决问题,那就是帮助读者熟悉知识点。
任何的形式、风格、注意点都是表面的东西。解决问题是关键。
一个写的再好的文档,不能姐姐问题,都是白搭。六、注意积累。
2.谁知道企业技术文档管理怎么写
我手头有个资料供你参考:目 次 前 言 II1 范围 12 职责 13 技术资料管理内容和方法 1 前 言 本办法是在贯彻国家有关技术政策、法规及国家标准的基础上,根据企业改革及生产经营的需要,结合本公司的实际情况制定的。
本办法由虎牌控股集团有限公司提出。本办法的起草单位:技术中心。
本办法的主要起草人:陈必君、龙骥、陆炳权。技术资料管理办法1 范围 本办法规定了公司技术资料的管理,技术文件的编制、审批、更改、保存等相关内容。
本办法适用于公司技术资料的管理。2 职责2.1 技术资料管理实行集团公司、子公司(包括控股公司和成员企业,以下同)二级管理,在集团公司技术中心的统一管理下,各技术管理部门应按照本办法的规定,各自承担技术资料的管理、使用、实施等职责,努力做到技术资料的正确性、完整性、统一性。
2.2 技术中心2.2.1 根据各子公司上报的信息,制定技术管理工作目标和计划指标。坚持正确性、完整性、统一性的原则,将技术管理的各项任务层层分解,落到实处,并建立和完善技术管理体系。
2.2.2 负责收集各子公司技术资料管理计划。2.2.3 定期检查各子公司技术资料管理实施情况,检查技术资料是否完整,下发文件是否统一。
2.3 各子公司技术部(技术管理员)2.3.1 认真履行集团公司技术管理的各项规章制度和管理办法并结合本单位实际情况,制订相关技术管理细则。2.3.2 合理使用和管理本单位的技术资料,按照正确性、完整性、统一性的原则,确保技术资料实施的有效性。
2.3.3 编制本单位技术管理的年度计划。3 技术资料管理内容和方法3.1 技术资料的编、审、批3.1.1 技术资料由相关技术部门负责编制。
3.1.2 各公司技术主管负责技术资料的审核。3.1.3 各标准化员负责对技术资料进行标准化审查。
3.1.4 各总工程师负责技术资料的批准。3.2 技术资料的更改3.2.1 技术资料的更改原则 —— 技术资料的更改不得降低产品质量,亦不得违背有关标准的规定,更改后的图样及文件应正确、完整、统一、清晰;—— 技术资料的更改必须按技术责任制的规定履行签署手续,并保证更改前的资料有据可查,原资料持有单位有权有新资料;—— 更改技术资料时,相关文件如同一代号不同介质的CAD文件应进行相应的更改,以保证相关文件的协调一致。
3.2.2 技术资料更改权限 —— 自行编制(设计)的技术资料更改权限属编制或设计部门;—— 外协的图样及文件,外来的技术资料更改权限属购入单位的设计或编制部门;—— 统一(联合)设计的产品图样及文件,由负责保管底图的部门单位,向持有该图的复印图或副底图的单位发出通知单副本(或复印图),该单位根据更改通知单副本(或复印图)进行更改。公司碰到不改无法生产时,经公司主要技术负责人批准,允许先改,后报统一设计组;—— 技术引进技术资料更改权按技术引进合同规定办。
3.2.3 技术资料更改顺序 各子公司技术主管负责对技术资料更改进行审批,各子公司技术部门组织相关人员对技术资料的更改进行评审或会签,各子公司技术主管下达技术资料更改通知单(书面文件);如有重大项目资料更改,应由技术部负责人填写技术资料更改申请单,各公司技术主管审核,报技术中心总工批准;更改记录需报技术中心备案。3.2.4 技术资料更改方法 参照JB/T 5054.6-2000《产品图样及设计文件更改办法》的相关规定。
3.2.5 技术资料的发放和保管3.2.5.1 技术资料发放 各子公司技术资料由各技术分中心加盖“受控”章后发放到相关责任部门,并在《文件发放记录表》上登记,由领用人签名。3.2.5.2 技术资料使用和保管 各技术分中心根据工作需要合理发放给使用者;使用者要妥善保管好文件,使用者未经技术部许可,不得擅自复印、外借技术资料。
有遗失及损坏情况应及时报技术管理部办理补发手续。3.2.6 各公司所使用的技术资料一律由各技术分中心档案室统一保管。
3.2.7 对回收的技术资料由技术中心统一管理。3.2.8 借阅技术资料要进行登记并由借阅人签字。
借阅人不得污损技术资料,归还时应登记、签字。如有污损,借阅人应向档案室人员声明。
如是公司机密技术资料,则借阅人不得将资料带出公司,不得转借他人,借阅完毕后,应立即归还档案室。