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