課程簡(jiǎn)介
在敏捷實(shí)踐越來(lái)越深入和普及的現(xiàn)代化研發(fā)團(tuán)隊(duì),隨著團(tuán)隊(duì)規(guī)模的發(fā)展和項(xiàng)目規(guī)模的變大,逐漸出現(xiàn)了敏捷輕文檔和高復(fù)雜度項(xiàng)目需要文檔規(guī)范之間的矛盾。前線員工越忙就越?jīng)]時(shí)間寫文檔,項(xiàng)目參與人數(shù)越多就越增加了對(duì)文檔的需求。本課程圍繞文檔對(duì)項(xiàng)目的核心價(jià)值,謹(jǐn)慎控制文檔的數(shù)量、重點(diǎn)聚焦文檔的質(zhì)量。由講師的實(shí)際項(xiàng)目經(jīng)驗(yàn),分享敏捷、效率、文檔、規(guī)范之間的平衡策略,有當(dāng)堂演示講師的實(shí)際項(xiàng)目文檔管理成果。并分享文檔背后更深層次的如何系統(tǒng)化、結(jié)構(gòu)化地梳理思路、做好設(shè)計(jì),以及跨團(tuán)隊(duì)協(xié)作時(shí)的文檔內(nèi)容評(píng)審確認(rèn)機(jī)制。盡量在有限的時(shí)間投入下,盡可能最大化文檔價(jià)值輸出對(duì)項(xiàng)目的未來(lái)指引、執(zhí)行保證、各方共識(shí)以及知識(shí)傳承,既不會(huì)墮入重型文檔的枷鎖,也不會(huì)任由完全反文檔的失控。
目標(biāo)收益
1、掌握文檔精簡(jiǎn)方法:學(xué)會(huì)如何在敏捷開發(fā)中平衡文檔數(shù)量與質(zhì)量。
2、提升文檔復(fù)用性:通過模板和架構(gòu)設(shè)計(jì)提高文檔的通用性和效率。
3、明確文檔核心價(jià)值:理解文檔對(duì)項(xiàng)目執(zhí)行、共識(shí)和知識(shí)傳承的作用。
4、優(yōu)化文檔確認(rèn)流程:掌握需求、設(shè)計(jì)、測(cè)試、運(yùn)維文檔的確認(rèn)實(shí)踐。
5、避免文檔管理誤區(qū):從講師親身經(jīng)歷中反思重型文檔與無(wú)文檔的代價(jià)。
6、構(gòu)建文檔生命周期管理:學(xué)習(xí)如何歸檔、維護(hù)和測(cè)試文檔,確保長(zhǎng)期價(jià)值。
培訓(xùn)對(duì)象
1、研發(fā)團(tuán)隊(duì)成員:包括開發(fā)、測(cè)試、運(yùn)維等技術(shù)人員。
2、項(xiàng)目經(jīng)理:負(fù)責(zé)項(xiàng)目管理和跨團(tuán)隊(duì)協(xié)作的人員。
3、技術(shù)團(tuán)隊(duì)負(fù)責(zé)人:需要制定研發(fā)規(guī)范和文檔策略的管理者。
4、敏捷實(shí)踐者:希望在敏捷開發(fā)中優(yōu)化文檔管理的團(tuán)隊(duì)成員。
5、文檔管理人員:負(fù)責(zé)文檔編寫、審核和維護(hù)的人員。
6、新入職員工:需要快速上手項(xiàng)目文檔的新人。
課程大綱
文檔的價(jià)值與代價(jià) |
1、后敏捷時(shí)代重新思考文檔的價(jià)值 -傳統(tǒng)方法太依賴文檔;敏捷太反對(duì)文檔,從一個(gè)極端跳到另一個(gè)極端的代價(jià)與反思 -實(shí)例分享:講師在兩家公司的親身經(jīng)歷: (1)重型文檔帶來(lái)的痛苦、(2)完全反文檔付出的代價(jià) -文檔:對(duì)大團(tuán)隊(duì)和小團(tuán)隊(duì)是不同的概念 -何為成熟團(tuán)隊(duì)的“剛剛好”的文檔 2、哪些文檔該精簡(jiǎn)、哪些文檔該發(fā)力 -討論:如何定義“沒用的”文檔 -如何定義必須的文檔 -必須遵守的規(guī)范 -經(jīng)常查閱的手冊(cè) -必須記錄的要項(xiàng) -不能靠口頭傳達(dá)的規(guī)格 3、文檔哲學(xué) -文檔是對(duì)過去的記錄? -文檔是對(duì)未來(lái)的指導(dǎo)? -文檔是結(jié)論? -文檔是討論? |
第一步:文檔清晰 |
1、文檔不寫則以,寫則清晰 -文檔清晰的管理標(biāo)準(zhǔn) -文檔與流程的結(jié)合 -實(shí)例分享:需求、開發(fā)、測(cè)試、運(yùn)維天天互相撕,都要求對(duì)方“立字據(jù)”! -反思與解決 2、高質(zhì)量文檔模板 -需求文檔清晰度及穩(wěn)定度考量 -高質(zhì)量設(shè)計(jì)文檔書寫技巧 -高質(zhì)量測(cè)試文檔核心價(jià)值點(diǎn) -高質(zhì)量運(yùn)維文檔要素 3、信息完備度 -操作系統(tǒng)級(jí)別的軟件,如何做到任何一個(gè)細(xì)節(jié)都有據(jù)可查 |
第二步 文檔確認(rèn) |
1、文檔的確認(rèn) -對(duì)需求文檔的確認(rèn)流程實(shí)踐 -對(duì)設(shè)計(jì)文檔的確認(rèn)流程實(shí)踐 -對(duì)測(cè)試文檔的確認(rèn)流程實(shí)踐 -對(duì)運(yùn)維文檔的確認(rèn)流程實(shí)踐 2、文檔的生命周期管理 -工具分享:用什么工具管理文檔 -文檔的狀態(tài)定義及管理 -文檔不能寫完白寫,文檔是后續(xù)工作的指導(dǎo)和規(guī)范 -文檔的歸檔 3、用戶文檔的測(cè)試 -用戶文檔的書寫分工 -多語(yǔ)言用戶文檔的翻譯及管理 -用戶文檔的測(cè)試 |
第三步 文檔簡(jiǎn)化 |
提升文檔的復(fù)用性 -精雕模板、以一擋百 -技能轉(zhuǎn)換、經(jīng)驗(yàn)共享 -文檔也有架構(gòu)、通用及分層 -從需求到測(cè)試,一“板”到底 |
文檔類型 |
1、研發(fā)技術(shù)類文檔 -實(shí)例分享:研發(fā)過程文檔有哪些必須的文檔類型 -實(shí)例分享:研發(fā)規(guī)范性文檔有哪些必須的文檔類型 -運(yùn)維及基礎(chǔ)設(shè)施有哪些必須的文檔類型 2、團(tuán)隊(duì)日常管理文檔 -員工入職離職的組內(nèi)準(zhǔn)備項(xiàng)文檔 -新人入職(技術(shù)崗)快速上手的文檔及實(shí)踐 3、工具使用類的文檔 -版本管理工具文檔 -文檔管理工具文檔 -公司內(nèi)部系統(tǒng)使用文檔 |
總結(jié) |
1、高質(zhì)量的文檔是積累出來(lái)的,不是趕工趕出來(lái)的 2、總結(jié)本課提到的每種文檔由誰(shuí)來(lái)寫 3、實(shí)例分享:我們文檔雖多,但每個(gè)人文檔負(fù)擔(dān)不重。在時(shí)間上、空間上拉松,永遠(yuǎn)重視文檔的質(zhì)量多過數(shù)量 4、精簡(jiǎn)、有深度的文檔是一種修養(yǎng) |
文檔的價(jià)值與代價(jià) 1、后敏捷時(shí)代重新思考文檔的價(jià)值 -傳統(tǒng)方法太依賴文檔;敏捷太反對(duì)文檔,從一個(gè)極端跳到另一個(gè)極端的代價(jià)與反思 -實(shí)例分享:講師在兩家公司的親身經(jīng)歷: (1)重型文檔帶來(lái)的痛苦、(2)完全反文檔付出的代價(jià) -文檔:對(duì)大團(tuán)隊(duì)和小團(tuán)隊(duì)是不同的概念 -何為成熟團(tuán)隊(duì)的“剛剛好”的文檔 2、哪些文檔該精簡(jiǎn)、哪些文檔該發(fā)力 -討論:如何定義“沒用的”文檔 -如何定義必須的文檔 -必須遵守的規(guī)范 -經(jīng)常查閱的手冊(cè) -必須記錄的要項(xiàng) -不能靠口頭傳達(dá)的規(guī)格 3、文檔哲學(xué) -文檔是對(duì)過去的記錄? -文檔是對(duì)未來(lái)的指導(dǎo)? -文檔是結(jié)論? -文檔是討論? |
第一步:文檔清晰 1、文檔不寫則以,寫則清晰 -文檔清晰的管理標(biāo)準(zhǔn) -文檔與流程的結(jié)合 -實(shí)例分享:需求、開發(fā)、測(cè)試、運(yùn)維天天互相撕,都要求對(duì)方“立字據(jù)”! -反思與解決 2、高質(zhì)量文檔模板 -需求文檔清晰度及穩(wěn)定度考量 -高質(zhì)量設(shè)計(jì)文檔書寫技巧 -高質(zhì)量測(cè)試文檔核心價(jià)值點(diǎn) -高質(zhì)量運(yùn)維文檔要素 3、信息完備度 -操作系統(tǒng)級(jí)別的軟件,如何做到任何一個(gè)細(xì)節(jié)都有據(jù)可查 |
第二步 文檔確認(rèn) 1、文檔的確認(rèn) -對(duì)需求文檔的確認(rèn)流程實(shí)踐 -對(duì)設(shè)計(jì)文檔的確認(rèn)流程實(shí)踐 -對(duì)測(cè)試文檔的確認(rèn)流程實(shí)踐 -對(duì)運(yùn)維文檔的確認(rèn)流程實(shí)踐 2、文檔的生命周期管理 -工具分享:用什么工具管理文檔 -文檔的狀態(tài)定義及管理 -文檔不能寫完白寫,文檔是后續(xù)工作的指導(dǎo)和規(guī)范 -文檔的歸檔 3、用戶文檔的測(cè)試 -用戶文檔的書寫分工 -多語(yǔ)言用戶文檔的翻譯及管理 -用戶文檔的測(cè)試 |
第三步 文檔簡(jiǎn)化 提升文檔的復(fù)用性 -精雕模板、以一擋百 -技能轉(zhuǎn)換、經(jīng)驗(yàn)共享 -文檔也有架構(gòu)、通用及分層 -從需求到測(cè)試,一“板”到底 |
文檔類型 1、研發(fā)技術(shù)類文檔 -實(shí)例分享:研發(fā)過程文檔有哪些必須的文檔類型 -實(shí)例分享:研發(fā)規(guī)范性文檔有哪些必須的文檔類型 -運(yùn)維及基礎(chǔ)設(shè)施有哪些必須的文檔類型 2、團(tuán)隊(duì)日常管理文檔 -員工入職離職的組內(nèi)準(zhǔn)備項(xiàng)文檔 -新人入職(技術(shù)崗)快速上手的文檔及實(shí)踐 3、工具使用類的文檔 -版本管理工具文檔 -文檔管理工具文檔 -公司內(nèi)部系統(tǒng)使用文檔 |
總結(jié) 1、高質(zhì)量的文檔是積累出來(lái)的,不是趕工趕出來(lái)的 2、總結(jié)本課提到的每種文檔由誰(shuí)來(lái)寫 3、實(shí)例分享:我們文檔雖多,但每個(gè)人文檔負(fù)擔(dān)不重。在時(shí)間上、空間上拉松,永遠(yuǎn)重視文檔的質(zhì)量多過數(shù)量 4、精簡(jiǎn)、有深度的文檔是一種修養(yǎng) |