一次“研發(fā)文檔管理體系建設(shè)”沙龍實(shí)錄

surfacer

    XX月X日，來(lái)自XXXXX、XXXX、XXX、XXX、XXXX等公司的相關(guān)研發(fā)負(fù)責(zé)人，與XX的資深顧問(wèn)們共同參加由XX管理咨詢有限公司舉辦的《研發(fā)管理》沙龍系列活動(dòng)。
0 t- P' ?& X- ~7 l本次沙龍的主題是：“研發(fā)文檔管理體系的建設(shè)”。
) \( ?- o& g; s& T   沙龍上的氣氛輕松而活躍，與會(huì)者紛紛各抒己見。交流了文檔建設(shè)過(guò)程中的問(wèn)題和困難，分析了困難產(chǎn)生的原因，以及提出了一些有效的解決方法。包括文檔體系應(yīng)該包含哪些內(nèi)容，如何建立文檔體系，以及如何推行和有效的實(shí)施文檔管理，即如何有效的與績(jī)效考核相結(jié)合的問(wèn)題，與會(huì)者分享了各個(gè)公司的經(jīng)驗(yàn)和教訓(xùn)。
- u) S* o' M2 a: `; ^   XX顧問(wèn)結(jié)合與會(huì)者提出的問(wèn)題，也發(fā)表了一些建設(shè)性的意見和建議。會(huì)議結(jié)束后，大家都覺得收獲很大。XX組織的這種形式的沙龍給主管研發(fā)的經(jīng)理們提供了一個(gè)非常好的交流平臺(tái)，大家都受益匪淺。
( B9 c) y$ ?+ X0 x5 i
以下為沙龍對(duì)話記錄：
/ G( m# |* T  ~
. H; Z$ i, |% D, [/ |主持人：
   我們這個(gè)沙龍不是培訓(xùn)，所以我們隨意一些。文檔建設(shè)這個(gè)工作是非常難做的，我以前在XX公司當(dāng)了三年的項(xiàng)目經(jīng)理之后，把我調(diào)任了一個(gè)新的職務(wù)，叫文檔管理員。于是我的文檔工作就管了一年，所以我待會(huì)可以跟大家交流一下文檔管理的經(jīng)驗(yàn)和教訓(xùn)。
   今天大家發(fā)言圍繞幾個(gè)主題，第一就是文檔建設(shè)過(guò)程中遇到過(guò)哪些困難。舉個(gè)例子，比如說(shuō)文檔不齊備，一些文檔是錯(cuò)誤的，常常跟我們具體內(nèi)容對(duì)不上。以前我跟一些項(xiàng)目經(jīng)理聊天，這些項(xiàng)目經(jīng)理就跟我開玩笑說(shuō)，最好讓競(jìng)爭(zhēng)對(duì)手把我們的文檔都偷去更好，為什么呢?我們的文檔錯(cuò)得一塌糊涂，偷去準(zhǔn)把他們搞死。
   第二是為什么會(huì)出現(xiàn)這種問(wèn)題，我們要分析為什么會(huì)出現(xiàn)這種問(wèn)題的原因，不知道這個(gè)問(wèn)題發(fā)生的原因我們就不能從根上來(lái)解決這個(gè)問(wèn)題；
   第三，就是怎么解決。每個(gè)在座的都可以談一下經(jīng)驗(yàn)和教訓(xùn)。
（待續(xù)）

peace80

嚴(yán)格按照ISO9000的規(guī)則做肯定是一個(gè)很好的文檔管理體系。

surfacer

熊 X: 我先拋磚引玉。我們公司對(duì)剛剛X老師的問(wèn)題深有感觸。文檔不齊，文檔不對(duì)深深困擾我們的文檔工作。文檔不齊主要是工程師很忙，每一次都推托�！鞍パ�，這次這個(gè)文檔我先不做了，我下次一定補(bǔ)上”。這一次就漏了，慢慢積累下來(lái)就什么文件都有缺的。有文檔但就是都缺。文檔不對(duì)的問(wèn)題就更加嚴(yán)重了，每一次新發(fā)一份資料都沒(méi)有更新，我記錄了一下我們公司文檔至少有兩百多份吧，從來(lái)沒(méi)有更新過(guò)資料，那資料就肯定全是錯(cuò)的，錯(cuò)的一塌糊涂。
/ c1 @1 g7 l; @7 n; L6 c  Y然后解決問(wèn)題我們現(xiàn)在是這樣考慮的，我們準(zhǔn)備從紙件和電子件兩方面考慮，于是就引用了Notes。現(xiàn)在還是比較有成效。我們建立了一些電子流，比如說(shuō)一些文檔傳遞的電子流，文檔必須更新了以后才能往下走。然后建立了一個(gè)公用的數(shù)據(jù)庫(kù)一樣的，就是每一次圖紙都要往里面存，才能往下面走，但是因?yàn)楝F(xiàn)在是建立初期，還是有很多不完善的地方：怎么去維護(hù)? 怎樣去保證文檔的齊全，還是沒(méi)有一個(gè)根本的辦法，不能從制度上來(lái)保證。

張XX：你們有沒(méi)有一個(gè)關(guān)于研發(fā)文件的管理體系? 先不說(shuō)整個(gè)公司的文件，像剛才X老師講整個(gè)的體系建設(shè)。因?yàn)槭紫葲Q定你要出什么文檔，然后才能談你管什么文檔。就一個(gè)Project而言，從開始到Project的結(jié)束，你們現(xiàn)在有沒(méi)有一個(gè)文件說(shuō)明哪些文件必須出，在什么階段出？
- q1 R! ]$ a: b) N' D, |在一個(gè)project 開發(fā)的過(guò)程中會(huì)有很多文檔。有的是受控的，有的是不受控的。受控的話一般很多，就相對(duì)來(lái)講比較簡(jiǎn)單一些。比如一些牽扯到公司最重要的物料啊，設(shè)計(jì)變更啊，這肯定會(huì)受控，用note 管理的一般是受控的文件。但實(shí)際上研發(fā)中很多重要的文件，比如和生產(chǎn)或物料等其他部門牽扯問(wèn)題不是很多的時(shí)候，就不受控了。實(shí)際上這部分文件對(duì)Project來(lái)講，對(duì)以后的產(chǎn)品開發(fā)來(lái)講也是很重要的。
那么你們有沒(méi)有一個(gè)體系，就比如說(shuō)文件編碼吧。因?yàn)槟阄募�的目的就是怎樣最快的把它檢索到，要檢索的話，首先要有編碼，和物料編碼一樣，文件也要有編碼，你們有沒(méi)有一個(gè)規(guī)定，或者說(shuō)管理體系，規(guī)定什么文件采用什么編碼?
% C- B) m6 W! a' d, I8 E( o
% u$ l/ G/ w+ v5 Z5 G熊 X：這個(gè)是有的。就是我們有專門文件編碼的業(yè)務(wù)指導(dǎo)書，我們?cè)谇澳旮鉏SO9001的時(shí)候就已經(jīng)建立了這個(gè)文件，就是規(guī)定應(yīng)該有哪些文件，比如說(shuō)一立項(xiàng)就應(yīng)該有預(yù)研報(bào)告、產(chǎn)品設(shè)計(jì)規(guī)格書、市場(chǎng)調(diào)研報(bào)告等這些東西。
指導(dǎo)我們工作的最大的有三個(gè)流程：一個(gè)是開發(fā)設(shè)計(jì)流程；一個(gè)是變更流程；還有一個(gè)就是怎么量產(chǎn)，量產(chǎn)移交管管理程序。這三個(gè)的話，要輸出很多文件。這些文件我們也有一個(gè)專門的體系。在三個(gè)大的文件下面，我們又分了上百個(gè)業(yè)務(wù)指導(dǎo)書。比如說(shuō)文檔應(yīng)包含哪一些項(xiàng)。比如每次開會(huì)邀請(qǐng)哪些人等這都是固定的，第一個(gè)是在什么時(shí)間要開哪些會(huì)，每個(gè)會(huì)要準(zhǔn)備哪些文件，要輸出哪些文件這些都是有規(guī)定的。
" e) t0 L  A, M" B  l至于文件編碼方面我們也比較簡(jiǎn)單，比如說(shuō)SYPN我們的標(biāo)志然后橫杠1l，橫杠rb是我們研發(fā)，然后橫杠后面就很簡(jiǎn)單了。比如說(shuō)03001，零三年的第一份 。不按Project分，就是任何一個(gè)Model都可以。就是說(shuō)從開發(fā)部發(fā)出的文件都是RD-03001為順序的。

張XX：通過(guò)部門文員往其他部門發(fā)的文件，大部分公司也都會(huì)這樣登記。因?yàn)槲膯T最基本的發(fā)出去文件他要登記編號(hào)。但在Project里不見得所有的文件都通過(guò)文員往外發(fā)。
. S% Z+ M% {5 G$ S
7 N  p% b* D: b; Y( H" ~9 P熊 X：我們現(xiàn)在基本上不容許文件私下給別人，全部都是文員給，全部通過(guò)一個(gè)接口。我要找什么文件的時(shí)候大概一搜索就可以找出來(lái)

張XX：你是電子登記，就是在Excel里面列個(gè)表，把他打進(jìn)去，然后把文件名也打進(jìn)去，或者是還有編碼也打進(jìn)去，那這樣如果我要找某一個(gè)Project 文件的話怎么找？
$ U$ T0 J* P9 ?
0 |1 ~7 N' t/ ^6 Q4 @1 p熊 X：檢索，按關(guān)鍵字來(lái)找。但我們下面一步就想做一個(gè)公用的平臺(tái)，分Project，每個(gè)項(xiàng)目組分給他一個(gè)區(qū)，但都是保密文檔，這個(gè)區(qū)的密碼由每一個(gè)項(xiàng)目經(jīng)理管，但這個(gè)電腦的開機(jī)密碼比如說(shuō)由我管，所以說(shuō)他獨(dú)自拿不到這個(gè)文件，然后我也拿不到這個(gè)文件，因?yàn)槲也恢�道各區(qū)的密碼，而辦公室的鑰匙則由我們主管拿著。
4 {8 o% ~$ Y' T+ m* @
張XX：你的File沒(méi)有按Project區(qū)分，你這個(gè)Project完成的時(shí)候又要結(jié)束這個(gè)Model，結(jié)束Model時(shí)你要去先看文檔，像你這樣你是不同的Projece在一起，你怎么去Check這個(gè)項(xiàng)目小組，怎么看這個(gè)文件有沒(méi)有完成？一個(gè)Project 完成以后怎么保證每一個(gè)文檔都是最Update?
6 J  M8 @6 Y5 I* O
熊 X：是這樣的，在項(xiàng)目完成的時(shí)候，包括結(jié)構(gòu)性圖紙、電子原理圖啊，這些全部要交到公司的文檔中心去管理，交一份整套的過(guò)去，起一個(gè)管理的職能。這時(shí)文員每一次復(fù)印的時(shí)候會(huì)多復(fù)印一份，另外裝訂成冊(cè)，按Project 這種形式裝訂成冊(cè)，然后他每一次零一版產(chǎn)生后，就會(huì)把零零版作廢。
這樣一般到最后都會(huì)有欠的文檔，到最后就催他們趕快補(bǔ)齊，列個(gè)清單給他們，因?yàn)槲覀兠炕刈詈笠淮涡∨�量生產(chǎn)的時(shí)候公司的文檔中心都要簽字的，要給項(xiàng)目組打分，文檔不全就不簽字，逼迫他們補(bǔ)文件，補(bǔ)到文檔中心滿意為止。就是說(shuō)在小批量生產(chǎn)之前有一個(gè)評(píng)審，在這個(gè)時(shí)候督促他們補(bǔ)齊，不補(bǔ)齊的話就不能轉(zhuǎn)量產(chǎn)。

張XX： 因?yàn)槟闶亲鰧?duì)講機(jī)的，肯定也是系列產(chǎn)品或者是新產(chǎn)品，實(shí)際上在一些核心的東西上基本上是共用的，這樣你的文件更顯得重要，因?yàn)槟愕囊粋�(gè)新的Project Team 開發(fā)一個(gè)新產(chǎn)品，可能只是在某一個(gè)原來(lái)的Model的基礎(chǔ)上修改了一些東西，那你怎么去節(jié)省時(shí)間呢，你要把原來(lái)的文檔要拿出來(lái)看。
5 t8 T% D; I7 Y
熊 X：我們現(xiàn)在就是分了很多柜子，每一層一個(gè)系列，每一個(gè)機(jī)型是一層，但一個(gè)機(jī)型里面分很多系列機(jī)型。

$ C# P3 j: ^9 M9 |6 d( }9 ~: Q6 b張XX： 但你一個(gè)系列機(jī)型按這個(gè)流水號(hào)的話等于你的號(hào)在跳，你看不出來(lái)全還是不全。假如說(shuō)這個(gè)Project 從001開始，先不管它是不是update……
/ P( P. V' `  J. Y3 x# G( B; h
熊 X：但這之后你應(yīng)該是有Bom的，對(duì)著Bom清單你就知道全不全。就是說(shuō)從你的文件里面專門對(duì)每個(gè)Project，然后把他挑出來(lái)形成一個(gè)List。你每一個(gè)機(jī)型，不管什么機(jī)型，就算是同一類型機(jī)型都會(huì)有一個(gè)Bom的，我指物料單。

張XX：從物料單只能check針對(duì)不同Part 的圖紙文檔及相關(guān)part的spec。但還有開發(fā)文檔，最大的問(wèn)題是在研發(fā)過(guò)程中的過(guò)程文檔。如概要設(shè)計(jì)報(bào)告，詳細(xì)設(shè)計(jì)報(bào)告。概要設(shè)計(jì)報(bào)告這些東西，你不交的話可能5年都沒(méi)事。
, k, o3 v/ ]: O
熊 X：這正是我們部門的工作，我們部門會(huì)有一個(gè)清單，不管它是什么機(jī)型，他都要交這些東西，比如一頁(yè)報(bào)告，你可以很簡(jiǎn)單，見xxx文檔，如果是新立項(xiàng)的話會(huì)寫的很厚一本，如果是客戶要求的那就會(huì)見合同等，我們每一個(gè)機(jī)型都會(huì)有從開始預(yù)研報(bào)告、設(shè)計(jì)開發(fā)手冊(cè)、到后來(lái)要輸出什么文檔，就會(huì)有一個(gè)清單出來(lái)。
我們文員就拿著這個(gè)文檔清單去查看。他不管文檔的具體質(zhì)量，因?yàn)橘|(zhì)量最后要由其他專業(yè)人員來(lái)評(píng)審的，所以說(shuō)做得不好也是有的，質(zhì)量問(wèn)題通過(guò)評(píng)審就可以看得到的，比如說(shuō)模具費(fèi)開模等多少錢呀，等不可能都寫見xx，最后還是會(huì)寫一下。這樣工程師還是會(huì)老老實(shí)實(shí)寫出來(lái)的。
7 g4 e; {8 T; G8 `
張XX：我覺得你們這個(gè)考慮文檔已經(jīng)考慮的很多了，假如說(shuō)到最后這個(gè)Project 完成的時(shí)候你都可以有個(gè)List，那你們這些文檔有沒(méi)有一個(gè)模版？因?yàn)槟銢](méi)有模版的話有些人可能做三行，有些人可能做三頁(yè)。
. |, X; K( d8 G4 {. q% f' Z: o
熊 X：以前我們沒(méi)有模版。規(guī)定相關(guān)的內(nèi)容都要有，但模版可以發(fā)揮�，F(xiàn)在就想做成模板式的，但由我來(lái)做了一個(gè)模板之后，大家都說(shuō)不好用。

' R- X! H; Y* i, r- M1 I6 K! B(待續(xù)）

universal

顯而易見，因?yàn)椴粫?huì)研發(fā)，所以才不知道什么時(shí)候出文檔，文檔該怎么出，怎么管理。補(bǔ)一句，研發(fā)方式也是有好幾類模型的，往往有例可援

jixiexu

我們?cè)诠芾硪泊嬖谶@樣的問(wèn)題，往往看的不夠遠(yuǎn)，事情過(guò)后發(fā)現(xiàn)很多事情有矛盾，但改正卻要花費(fèi)很大功夫，甚至忙不過(guò)來(lái)，以至于錯(cuò)誤繼續(xù)……

surfacer

主持人：那是自然，做得再好都會(huì)說(shuō)不好用，模版要工程師去做，讓他們自己做他們不會(huì)說(shuō)不好用的。工程師覺得模板不好用，但他又拿不出一個(gè)更好用的模板來(lái)，而且他說(shuō)的都是客觀存在的理由，舉例告訴你這里為什么不好用。

4 i# y, t* \, M/ J/ a熊 X：但模板是可以慢慢的修改，先做個(gè)初步的出來(lái)。我們會(huì)在成型文件里會(huì)說(shuō)預(yù)研報(bào)告要包括市場(chǎng)調(diào)研、市場(chǎng)分析等。
/ S4 k( a. p1 I5 L# C
* O- E: P# [" W% T張XX：在一個(gè)Project 開發(fā)的過(guò)程中，有沒(méi)有一個(gè)單獨(dú)的文件，規(guī)定在什么階段出什么文件。就是說(shuō)在這個(gè)Project一開始就已經(jīng)規(guī)定了在什么時(shí)間出什么文件，因?yàn)椴煌�的Project 是不一樣的。

+ h; z0 b, i! R0 Q熊 X：有。而且這些文件都要評(píng)審的。我們一開始就會(huì)有幾張紙出來(lái)，列出哪些是要評(píng)審的，這個(gè)(資料)就交給項(xiàng)目組，給他們看。你要經(jīng)過(guò)這些，然后輸出什么文檔，最后就是文員在那里打?qū)�勾，相�?dāng)于一個(gè)Check List ，然后可能會(huì)增加一些評(píng)審點(diǎn)，那就在后面加。后來(lái)會(huì)發(fā)現(xiàn)評(píng)審多了一些，比如客戶突然有什么反饋呀，就是說(shuō)固定的評(píng)審他必須做。

" ?5 I$ E: Y0 J# c9 p* W, V張XX：真正要把一個(gè)Project文件搞齊備的話，真的很麻煩。
& i+ v7 t- {3 l8 L- ?9 o
( a+ u# x# ~" n7 F7 _& N% |熊 X：而且最大的問(wèn)題不是有沒(méi)有，而是時(shí)間上對(duì)不對(duì)的上，就是說(shuō)應(yīng)該是1月1日出的文件，可能到7、8月才有這個(gè)文件。明天又是內(nèi)審，那個(gè)內(nèi)審員最清楚我們的問(wèn)題就是時(shí)間對(duì)不對(duì)的上，每次文件都有，但是一看：預(yù)研評(píng)審是在1月1日，為什么你這個(gè)文檔還在7月還在填。這就類似于用ISO來(lái)檢查前偽造文檔。

$ L. o' w; ~8 U: K" O& R0 F劉 X：我想問(wèn)一下，現(xiàn)在有一些文檔管理的軟件，里面也反映了基線。版本反映在軟件里面了，而且實(shí)時(shí)可以去提供的，是根據(jù)服務(wù)器網(wǎng)絡(luò)來(lái)，大家有沒(méi)有考慮用這種軟件。
( X; F4 n1 M- L) ]+ q, P' s9 J8 e# X前段時(shí)間北X青X到我們公司來(lái)推薦軟件，當(dāng)時(shí)一個(gè)是經(jīng)費(fèi)的問(wèn)題，另一個(gè)問(wèn)題就是他向我做介紹的時(shí)候，也說(shuō)了一些像我們這樣的公司在用他們的軟件，還給出了某一個(gè)項(xiàng)目里面的具體的文檔，然后對(duì)我說(shuō)這是比較機(jī)密的資料，具體內(nèi)容不能讓我看，但還是有一些具體的內(nèi)容出來(lái)了，我在想，因?yàn)檫@都是和服務(wù)器掛上的，會(huì)不會(huì)在這些軟件里邊會(huì)有后門，會(huì)不會(huì)我們?cè)谟眠@些軟件的時(shí)候他就已經(jīng)知道我們的技術(shù)資料了。

黃XX：那要看你的網(wǎng)。比如政府的內(nèi)網(wǎng)和外網(wǎng)是徹底隔離的。就是物理隔離。

6 T3 ~2 J6 A6 O1 X3 f張XX：基于web的話是很方便的，但安全是一個(gè)問(wèn)題，我們現(xiàn)在已有一個(gè)客戶在用基于oracle和metaphase而開發(fā)的系統(tǒng)，我們現(xiàn)在要進(jìn)入這個(gè)系統(tǒng)要四個(gè)code，一個(gè)username ，一個(gè)password還有一個(gè)pincode，還有一個(gè)number，這個(gè)隨機(jī)number專門有一個(gè)生碼器生成它，在我把Pincode 輸完后再輸入這個(gè)隨機(jī)碼。生成哪個(gè)碼就是這個(gè)碼。

黃XX：我們給客戶的都用活體指紋。

: }) t: \6 f. M熊 X：我們就用鑰匙，密碼和人分離的方法。

& f1 q1 D- {8 }# O; m/ a/ d

surfacer

張XX：你要基于Web的話，和你的供應(yīng)商、和你的客戶溝通之間不存在問(wèn)題，假如說(shuō)你今天在深圳，明天到上海去了，你照樣不影響你的工作，只要帶個(gè)筆記本電腦，上網(wǎng)就行了。不論走到任何地方，你和你的客戶用的是同一個(gè)平臺(tái)。
# q3 _3 i6 X9 U. |7 X) ]5 v
黃XX：我們?cè)谖臋n建設(shè)方面也遇到大家所講的問(wèn)題。你們可能都是電子類、消費(fèi)類產(chǎn)品，我們就是純軟件的，所以文檔就更重要。
- h6 u& r. K4 |2 {/ e比如項(xiàng)目經(jīng)理要查一些東西，如果沒(méi)有文檔的話，就非常難維護(hù)。跟進(jìn)過(guò)去要花半個(gè)月至一個(gè)月時(shí)間，而且我們的文檔最初始的需求是這樣的，根據(jù)這個(gè)需求會(huì)派生出一系列的文檔來(lái)，比如概要設(shè)計(jì)、分析、詳細(xì)設(shè)計(jì)、甚至用戶手冊(cè)這一整套的東西。因?yàn)樾枨笫墙?jīng)常變更的，一般來(lái)講，能保證需求方面的文檔能達(dá)到比較新的程度，比如最近一個(gè)月。但是對(duì)后續(xù)的，比如說(shuō)分析方面就比較難了。
* C- |5 g3 |- y. E' a0 P/ o我們?cè)谌粘５墓芾碇幸蚕肓艘恍┺k法，第一就是給這些研發(fā)管理人員進(jìn)行培訓(xùn)，提高對(duì)文檔的認(rèn)識(shí)，因?yàn)榇蠹叶加X得我做的就是產(chǎn)品，我把產(chǎn)品做出來(lái)給客戶了就OK了，文檔又不能賣錢，但實(shí)際上文檔在驗(yàn)收當(dāng)中是很重要一項(xiàng)。
第二就是像一些內(nèi)容能快速的對(duì)文檔進(jìn)行變化更新的跟進(jìn)機(jī)制，比如我們自己開發(fā)的一些文檔生成工具。
8 J8 }9 Z" a& d9 Q/ ?第三就是剛才大家提到的采用標(biāo)準(zhǔn)的文檔格式，這有幾個(gè)好處，第一寫的時(shí)候有針對(duì)性，比如客戶的需求，一般需求是什么，在特殊情況下有什么需求，還有這個(gè)分析基本的功能有哪些，特殊的功能有哪些，分條分塊，既方便寫又方便看，也方便交流。
第四點(diǎn)就是把文檔提高到一個(gè)配置管理高度來(lái)講，把它跟代碼，設(shè)計(jì)文檔都當(dāng)作配置項(xiàng)，定期的由配置管理員進(jìn)行一些審核，然后對(duì)驗(yàn)收前等重大的也是組織評(píng)審。

熊 X：文檔最值得借鑒的就是日本的文檔。他們交過(guò)來(lái)的OEM文檔真是齊整。老外作文檔做得真不錯(cuò)，幾乎到了傻子都能看懂的地步。他們的文檔從一份文檔就可以看出經(jīng)過(guò)了多少次變更，每次變更的內(nèi)容。

黃XX：我們開頭的第一頁(yè)都是文件變更控制，什么時(shí)候由誰(shuí)變更了哪一部分。但實(shí)際上這些都是空的。文件編號(hào)到3.0，4.0，我們現(xiàn)在都是1.01、02、03這樣編碼，然后有重大的變更的話就取2.0，再有大的話就3.0，我們編號(hào)的規(guī)則可能跟你們不一樣，我們是按項(xiàng)目來(lái)分的，比如說(shuō)深圳市建設(shè)局……
$ D: _+ }$ D6 S- ^) g6 y- P4 }# C而像這種游離在正規(guī)的編號(hào)之外，比如某年某月關(guān)于某重大需求的會(huì)議的會(huì)議記錄，這個(gè)我們就專門搞一個(gè)目錄，我們用Vsourcesafe，主要就是當(dāng)作一個(gè)文件服務(wù)器。項(xiàng)目文件里包含會(huì)議記錄、周報(bào)、月報(bào)等，但技術(shù)文檔在不在編號(hào)里。

熊 X：我們公司和你們公司不一樣，我們公司是有一個(gè)項(xiàng)目開發(fā)手冊(cè)，其中有一欄里邊專門放置會(huì)議記錄，周報(bào)，月報(bào)等，這樣便于以后查找。
, f- ~3 F8 G5 ~  ^) T# g; G
張XX：你的項(xiàng)目文檔在編碼系統(tǒng)里是怎么樣編的？

黃XX：比如說(shuō)測(cè)試。包括測(cè)試反饋方面我們也專門有一套文檔。這套文檔是這樣的，在測(cè)試的初期按照功能模塊來(lái)，我們分為單元測(cè)試等。至于文件的編號(hào)則統(tǒng)一的比如xx系統(tǒng)第一次測(cè)試，里面有很多個(gè)文件，差不多的時(shí)候就拼成一個(gè)文件，用Word或Excel。

張XX：Software你要測(cè)試的話，首先要有一個(gè)Instruction，就是說(shuō)如何去測(cè)，然后根據(jù)你這個(gè)指導(dǎo)書再去測(cè)，相當(dāng)于一個(gè)實(shí)驗(yàn)報(bào)告。
9 {! |+ o/ G) l
黃XX：原來(lái)有些項(xiàng)目的客戶就要求我們有測(cè)試計(jì)劃。測(cè)試計(jì)劃里邊包含測(cè)試樣例，輸入是什么東西，輸出是什么東西等�，F(xiàn)在軟件測(cè)試還包括很多東西，包括軟件功能有沒(méi)有達(dá)到，如邏輯功能，我輸入某個(gè)東西，在某一塊是否輸出什么東西。我們以項(xiàng)目為主，每個(gè)項(xiàng)目有一個(gè)編號(hào)。

張XX：那假如說(shuō)想找一個(gè)幾年前的項(xiàng)目，怎么樣很快的去找到。

4 @. g( I+ q, v6 V% \* ~黃XX：就是在Vsourcesafe里的項(xiàng)目的目錄里源代碼、數(shù)據(jù)庫(kù)、文檔等這些方面都有。如果配置管理做好，這些問(wèn)題就可以搞定。起碼這些文件在邏輯上是可以找到的，在物理上可能是一個(gè)文件。
另外在我們配置管理里面有這種編號(hào)，就有點(diǎn)像順序號(hào)，如果他是文檔的話，我們就叫Doc001，就是針對(duì)項(xiàng)目里面的，但這些主要是用來(lái)配置管理自己看一看的。

surfacer

熊 X：這個(gè)找起來(lái)我覺得還是比較快的，每次不會(huì)超過(guò)一分鐘，只要知道內(nèi)容。關(guān)鍵是你找到他對(duì)你有沒(méi)有用。

張XX：我卻覺得找文檔是個(gè)問(wèn)題，一個(gè)項(xiàng)目完成，你至少要寫300個(gè)文檔。一個(gè)公司十年就有上千個(gè)Project ，你怎樣在上千個(gè)Project里，找?guī)啄暌郧暗哪骋粡垐D紙，或某一個(gè)具體的文檔。

黃XX：全文檢索。我們有這個(gè)軟件，比如你要找建設(shè)局會(huì)議，打關(guān)鍵字就出來(lái)了。這個(gè)軟件可以檢索的文件有兩種，一種存在數(shù)據(jù)庫(kù)里，一種就是純文件的光盤檢索系統(tǒng)。我們自己都開發(fā)出了文檔生成工具，更改后只要點(diǎn)一下，一百頁(yè)，六十頁(yè)的文檔就自動(dòng)生成出來(lái)了。
+ P; q1 v0 A; U
王 X：那你全文檢索肯定會(huì)出來(lái)很多很多文件，你還得在其中再找，這比較麻煩。
; b( P: A: J- a( \7 z
5 Q* D1 `9 z. I. y6 c黃XX：那這個(gè)就相當(dāng)于在搜索引擎上搜索東西一樣，你可以輸入會(huì)議日期，如果你自己也參加了，就可以打自己的名字再檢索。
6 |: h9 e8 S3 E/ d. s& r& i" A7 m
9 X; t8 W5 i" i1 K9 M: c  x王 X：我們公司的文檔很齊全，或者說(shuō)太多了。我們有System Requirment，然后Higtlight Design，Detail Design。還有用戶文檔。
' h# m4 @+ ]7 m2 d- s+ g3 d& ?( U我們一個(gè)系統(tǒng)很多個(gè)網(wǎng)員，會(huì)寫很多文檔。我們有一個(gè)文件系統(tǒng)叫PDS，可能是國(guó)外的，也是檢索，但是會(huì)有一個(gè)文檔上載人員。你可以把文檔上載上去，由他來(lái)決定他的關(guān)鍵字、項(xiàng)目、類別，然后存在數(shù)據(jù)庫(kù)里，我們每個(gè)人有一個(gè)密碼，我可以去搜索文檔，但問(wèn)題是，搜索出來(lái)的文檔很多，要么找不著，找著了也不是我所需的�？赡苁巧陷d人員對(duì)關(guān)鍵字的敏感度不好，另一方面，這個(gè)軟件可能在邏輯上真的有一定的問(wèn)題。
我們現(xiàn)在想的彌補(bǔ)辦法就是做一個(gè)Project這樣的網(wǎng)站，每個(gè)Project有一個(gè)網(wǎng)站，然后按網(wǎng)員來(lái)分。每個(gè)產(chǎn)品都有一個(gè)Excel文件，從里面列出了各類文檔在PDS上的number ，這個(gè)相對(duì)來(lái)說(shuō)就互補(bǔ)了一下，比較好，但就要求項(xiàng)目管理人員比較勤勞。因?yàn)楣�司已�?jīng)有一個(gè)PDS在上載文檔了，做不做Project網(wǎng)站僅僅是個(gè)人的意愿，根據(jù)自己的工作態(tài)度來(lái)做，但對(duì)于我們尋找文檔來(lái)說(shuō)就希望能兩者相結(jié)合。
文檔很多，該怎么有效檢索的問(wèn)題。全文檢索我覺得還不是很好，我們有一個(gè)軟件檢索的Public Document System，也是從國(guó)外引進(jìn)的，我感覺還是不很理想，我們經(jīng)常查找不到需要的文檔。

黃XX：我們的系統(tǒng)，比如要查江XX同志在xxx會(huì)議上的講話，打入關(guān)鍵字就可以了，關(guān)于這次會(huì)議的資料內(nèi)容就全部出來(lái)的。
" k$ y: ?3 f2 J( Z
9 m9 W+ @) r/ e, m& T7 a8 w張XX：我覺得文檔跟公司的重視程度有很大關(guān)系，看讓誰(shuí)去做。比如開發(fā)文檔要讓開發(fā)部的主管或Manager參與，去建立體系，不然就會(huì)面臨很多問(wèn)題。
; Q- w! U& Q$ C. `$ S+ g2 J必須是一個(gè)職位比較高的人員，或者說(shuō)他本身就做過(guò)很多文檔，有切身體會(huì)，或在檢索中就遇到過(guò)這類問(wèn)題。比如我就有這類問(wèn)題。因?yàn)槲臋n最基本要有編號(hào)，Version，有歷史紀(jì)錄，命名，怎么保存，這些全都要標(biāo)準(zhǔn)化，但建立這些所花的工作量是很大的。而且你的目的就是檢索要快，才能提高你的文檔的利用率，對(duì)以后的開發(fā)縮短時(shí)間。
但現(xiàn)在我們的客戶按Project，做得很復(fù)雜，但他們要找文檔很簡(jiǎn)單�？蛻羰沁@樣做的，像我們做一個(gè)Bom，你的產(chǎn)品是分層的，你的物料在Bom里是分Level的，我的客戶是這樣做的…………他們的編號(hào)每個(gè)字母都代表一定的含義。他的Bom是個(gè)Part，還是其他，在他們的編碼里邊都可以體現(xiàn)出來(lái)。你看索尼愛立信手機(jī)上都是KRY開頭，裝成整機(jī)以后就是KRY開頭了。包裝盒是DPY開始，只要把碼輸入系統(tǒng)，所有的相關(guān)文檔資料就出來(lái)了。
% |" D2 V' W/ N$ ~6 A& p- k
（待續(xù)）

surfacer

看來(lái)大家興趣不大，不更新了

李澤

呵呵。這個(gè)文風(fēng)很有趣啊