敏捷開發之設計文件

2022-03-15 09:18:54 字數 831 閱讀 1824

對於設計文件的一點體會就是,明確需求、精簡語言、**並繪、**相輔、易於溝通。

下文援引:

在產品研發過程中經常需要編寫很多文件,例如:需求文件、設計文件、api文件、驗收文件等等。團隊成員要花費很多精力去維護眾多的文件,甚至有「兄弟,我替你寫**,你替我寫文件」的無奈。

敏捷開發宣言

* 個體和互動 勝於 流程和工具

* 可以工作的軟體 勝於 詳盡的文件

* 客戶合作 勝於 合同談判

* 響應變化 勝於 遵循計畫

敏捷宣言的第二條「可工作的軟體勝於詳盡的文件」,很多人理解為敏捷開發不重視文件,甚至以此為藉口逃避寫文件。同樣,在對待」敏捷開發是否需要架構設計」的問題上也有類似極端的看法。

敏捷宣言在寫什麼樣的文件以及如何寫方面並沒有給出任何剛性的指導原則,那麼在敏捷管理的專案中我們該如何編寫文件呢?

首先,我們需要理解敏捷宣言背後的思想。

敏捷4條宣言都是在強調「價值」、「快速交付價值」、「為客戶提供價值」的理念。換句話說,研發團隊要把精力放在能夠為客戶帶來價值的地方,避免在不產生價值或者roi(投入回報率)低的任務上浪費時間。

其次,我們要理解文件的作用是什麼?文件是用來準確傳遞資訊,幫助理解事物,沉澱知識。

基於以上理解,在遇到是否要寫文件的疑問時,可以通過回答兩個問題來判斷

從文件的讀者來劃分

對於可以「簡寫」的文件,可以考慮使用markdown格式。

markdown是一種簡單易用的標記語言,使用者可以使用這些標記符號以最小的輸入代價生成極富表現力的文件。

敏捷開發之設計文件

對於設計文件的一點體會就是,明確需求 精簡語言 並繪 相輔 易於溝通。下文援引 在產品研發過程中經常需要編寫很多文件,例如 需求文件 設計文件 api文件 驗收文件等等。團隊成員要花費很多精力去維護眾多的文件,甚至有 兄弟,我替你寫 你替我寫文件 的無奈。敏捷開發宣言 個體和互動 勝於 流程和工具 ...

敏捷開發智慧型之寫不寫文件?

size medium b 緣起 b 我們產品已經做完了,客戶說要補上需求文件,可我們只有使用者故事,這個文件應不應該寫呢?沒有這個文件,客戶能驗收嗎?不能,客戶要開課題評審會,這個是評審會材料之一。這個文件要不要寫呢?寫,為什麼?不寫,為什麼?寫怎麼寫?不寫,怎麼不寫?b 為什麼敏捷不寫文件?b ...

敏捷軟體開發之什麼是敏捷設計

實際上滿足工程設計標準的唯一軟體文件,就是源 清單 jack reeves 僵化性 rigidity 僵化性是指難以對軟體進行改動。如果單一的改動會導致有依賴關係的模組中的連鎖改動,那麼設計就是僵化的。很難對系統進行改動,因為每個改動都會迫使許多對系統其他部分的其它改動 脆弱性 fragility ...