當前位置:首頁 » 電腦辦公 » 怎樣寫需求文檔
擴展閱讀
汽車怎樣開空調省油 2024-12-25 14:49:10
沒音響怎樣讓電腦放音樂 2024-12-25 14:41:36

怎樣寫需求文檔

發布時間: 2022-01-14 15:10:47

『壹』 怎麼寫項目需求文檔

如果你是真的想寫,希望你實地到超市去考察下,看看他們的工作流程,然後按流程寫,寫不好,至少是真實的,而且對你也會有幫助,如果不是,那你從網上找找,有很多

『貳』 怎麼寫需求文檔啊

我是個小學都沒畢業的人,但我還是知道你要寫的是什麼,需求文檔,你要明白,是你們公司需要的各種材料的內容,計費嘛這個你自己懂的。

『叄』 硬體需求文檔怎麼寫

1、首先根據功能分類
2、分別簡介結構、原理
3、介紹各部分採用的理由、特點
4、主要元器件的選擇及理由
5、列出元件列表。

不知是否是你需要的答復。

『肆』 如何編寫優質的需求文檔

需求文檔被用來定義開發任務,協調大規模的研發計劃。對於最終的產品,需求文檔扮演著開發者行為和消費者行為之間溝通紐帶的角色。當需求文檔書寫正確的時候,便可以發揮巨大的作用。然而,如果你在嵌入式開發領域工作的時間足夠長,你就會很快發現,這個領域里不合格的需求文檔實在是太多了。當你嘗試對這些不合格的文檔進行修復時,你又會很快發現,書寫正確的需求文檔絕非易事。在這里,我們提出一些建議,希望能將書寫正確需求文檔這件事情變得清晰一些。 從較高的層次來看,書寫需求文檔的目的就是要提供對所需行為的有效描述。該所需行為可用一個黑盒系統描述,並需要注意以下細節:工程師可以根據系統所說進行實現測試人員,在不與開發人員溝通的前提下,可以利用滿足硬體要求的設備驗證需求。最終產生的成果滿足終端用戶的要求。黑盒測試 書寫優質的需求文檔: 最基本的原則是:需求文檔應當盡量簡潔,用最易懂的描述來約束系統的預期行為。如果你遵循這個原則,剩下的那些重要因素(可測試性、避免過度設計等等)都將變得順理成章。 列舉一下更詳細的規則,通常會更有幫助。下面是書寫優質需求文檔需要遵循的步驟: 1. 定義系統的邊界。這也是黑盒系統所必要的。 2. 定義輸入和輸出。這也應當是你看待內部系統的唯一方式。 3. 用最易懂的方式描述系統的預期行為 4. 除了輸入和輸出之外,你的需求是不是還涉及了系統的其他部分?如果是,那麼你的需求就設計過度了。重構需求,讓它變得精簡。 5. 你的需求是不是過於模稜兩可?加入更多的限定規范。注意:有些模稜兩可的描述並不是壞事,假設描述所包含的所有情況均可被接受,且測試的時候不需要附加的信息加以說明,那麼就沒關系。你不需要(也不應該)把系統的行為限製得過頭。 6. 你的需求是否可測試?(這里指的是黑盒測試)如果不是,你最好返回到第 4 步。如果這種返工發生很多次,那就說明你的黑盒無法正確描述系統,或者你的測試工具不夠優秀。無論是哪種情況,不可測試的需求文檔幾乎就是一文不值的。 7. 你的需求文檔通俗易懂么?如果你的需求文檔非常難以讀懂,那就說明你寫得不好,只能給那些照著你的需求負責實施的人帶來無盡的痛苦。如果是這樣,回到第 3 步。 8. 你是不是真的做到了第 4 步?你確認么?再檢查一下。 例子:下面的例子,讓我們描述一個自製的嵌入式設備的需求,這個設備能從彎曲感測器上讀取彎曲的頻率,並根據不同的頻率值讓一個 LED 閃爍。 顯然,我們已經完成了步驟 2 和步驟 3 了! · 輸入:從彎曲感測器讀取數據。 · 輸出:LED。 但是我們跳過了步驟1: · 在這個例子里,我們將把黑盒畫到設備的微處理器上。 讓我們繼續往下進行, 第四步:除了輸入和輸出以外,我們是否還涉及了其他的系統邊界? · 微處理器並不關心從彎曲感測器讀取什麼樣的數據,從處理器的角度來看,僅需要做的是測量 ADC 腳的電壓而已。 · LED 僅由數字輸出腳控制。 下面,讓我們來修正這個問題: 第0 版本的需求: 1. 該設備應當根據 ADC 腳的不同頻率的電壓,來切換數字輸出端的狀態。 第五步: 需求寫模稜兩可么? 恩,我們的描述太模稜兩可了.輸出端切換的速度要多快? 跟電壓的關系如何? 輸入電壓的范圍是多少? 讓我們加一些更細節的描述吧: 版本0.1 1. 輸出端應當由一個自由活動的定時器進行控制 2. 自由運行定時器的頻率最高不得高於每秒 10 次,不得低於每秒 1 次. 3. 自由運行定時器的觸發頻率應當在最高和最低值之間呈線性變化,並與 ADC 端的輸入電壓成正比. 4. ADC 端的輸入電壓應當每 100 毫秒讀取一次 5. 當 ADC 端的輸入電壓端被讀入時,控制自由運行定時器周期時間的注冊值也應當被更新. 6. ADC 輸入端的電壓有效范圍應當被控制在 0 到 1 伏之間. 第六步: 你的需求是可測試的么? · 首先,自由運行的定時器在這里不需要提及. 因為對它基本上無法進行黑盒測試,它既不是輸入也不是輸出,而且跟這兩者也沒有什麼聯系。 讓我們用「數字輸出端變化的頻率應控制在每秒 10 次和每秒 1 次之間」來代替自由運行定時器的測試標准。 · 對於上述的第四條需求,可能需要一些小修改才能作為測試標准。讓我們用「ADC 端的輸入電壓應當保證在每 100 毫秒內至少被讀取一次」來加以描述,這樣的描述能讓我們預期的測試行為顯得更加通俗易懂。 · 需求的第五條也需要一些小修改。我們如何才能檢測電壓的輸出范圍是在 0 到 1 伏之間呢? 總不能給個 2 伏的電壓,然後看看元器件有沒有被燒毀吧? 那麼,說「檢驗系統在 ADC 端輸入電壓為 1 到 2 伏之間的時候,工作是否正常」,這樣就檢驗就容易多了。需求描述應當是「正面」的,應當描述設備「應該」的行為,而不是設備「不應該」的行為。否則的話,測試將會無法進行。 版本0.2 1. 數字輸出端的切換頻率應當控制在每秒 10 次到每秒 1 次之間 2. 數字輸出端的切換頻率應當在最大值和最小值之間呈線性變化,並與 ADC 端的輸入電壓成正比 3. ADC 端的輸入電壓應當保證在每 100 毫秒內至少被讀取一次 4. 檢驗當 ADC 端的輸入電壓范圍在 0 到 1 伏之間的時候,系統工作是否正常 第七步:你的需求是否通俗易懂? 相比於我們原來的描述:「根據彎曲感測器的輸出不同頻率來控制 LED 閃爍」,我們上面的那些需求描述顯得難以閱讀和理解。 我發現,讓需求文檔變得通俗易懂,最簡單辦法莫過於,把過於細節的東西抽取出來,然後以條目的形式單獨定義。 版本1 1. 彎曲感測器應當保證至少在 100 毫秒內讀取一次數據(放到注釋單獨列出) 2. 切換 LED 的狀態,使其與彎曲感測器的讀數保持一致 3. 當彎曲感測器的讀數為 1 伏特時,LED 狀態切換的次數應當保持在平均一秒十次;當感測器的讀數為 0 伏特時,LED 的切換次數應保持在一秒 1 次。 定義: · 彎曲感測器:輸入電壓位於 ADC 的X端。安全電壓范圍為 0 到 1 伏特(放到注釋單獨列出) · LED 狀態:數字狀態由Y端輸出 這樣就好多了(盡管還不完美)。這些需求通俗易懂,不涉及到系統內部實現,且易於測試。對於系統行為的限定也僅僅限於需要做什麼,點到為止。(例如,對彎曲感測器的采樣頻率,在實現上也可以更高,只要不產生非預期行為,一切都可以)。 編寫需求就彷彿是在大腦中構建軟體的過程。因此要重於實作。 編譯:伯樂在線 – 黃小非

『伍』 如何編寫優質的需求文檔

盡量簡短

沒有比這更重要的文檔寫作建議了。簡潔意味著清晰的思路和溝通,也意味著你的文檔更加易於閱讀和理解——這一點至關重要。


使用平白的語言和簡單的格式
使用簡短而不是花哨的語句,使用列表和加粗強調可以使文章更一目瞭然,以放鬆有趣的方式寫作而不是一板一眼,如果你有得體的幽默感就再好不過了。


為開發團隊預留時間
通過評審並且達成一致通過的文檔才是完善的文檔。如果你希望在未來的某一個迭代 Sprint 中開發此項目,就應該提前兩到三周開始這個產品文檔寫作流程。


像工程師一樣思考
在項目得以進入開發之時,常常會發現大量未預料到的邊緣情況——但這種情形其實可以避免。如果你認真考慮過項目進入開發的所有必要條件,你就可以提前發現這些問題(例如,是否在移動設備中可以使用在線聊天功能?)。


確保每一個人都跟上了你的節奏
當我組織產品評審時,會議室里的大部分人都已經大致了解我要講的內容——因為我已經提前在討論會和日常聊天中溝通過這個事情了。既然大家都已經清楚了「做什麼」和「為什麼要做」的問題,文檔評審會上我們只要關注實施細節就好了。


在圖表中下功夫
流程圖、線框圖等圖表可以通過易於理解的方式提供很大的信息量,同時也需要消耗非常多的時間來製作這些圖表。


在思考和寫文檔上花 0.5-3 天時間
具體時間根據項目大小而定。花費在寫文檔上的時間越長,所帶來的邊際收益就會遞減。特別需要指出的是,沒有人能夠讀的下去超過 5-6 頁的文檔。


指明方向,明晰願景
你不僅僅是在定義一個功能,也是在解釋「為什麼我們要做這件事情」以及「我們的目標是什麼」,在文檔中指出這個項目將會對更高層面的規劃造成什麼影響,以及接下來會發生什麼。


確保你的觀眾閱讀了文檔
如果你的文檔又臭又長,或者從來不分享給對應的人,那你還不如不寫文檔。務必確保你的文檔被對應的人閱讀了,我上面關於評審開始時留時間給大家讀文檔的建議值得大家參考。


獲取真誠的反饋
你的文檔是否是在贅述人盡皆知的事情?或者是文檔缺乏足夠的細節?是否在後續實施中發現了太多的邊緣情況?又或者,是否在制定計劃和文檔評審上耗費了太多的時間?你應該和你的團隊時刻保持溝通。

『陸』 java 項目需求文檔要怎麼寫

5.在線預覽、分享更便捷

在摹客中在線撰寫或上傳的產品需求文檔,可通過鏈接快速分享給團隊成員,團隊成員獲得鏈接後可自由查看,當產品需求文檔有修改時,團隊成員仍可通過鏈接查看最新版本。

使用摹客等高效便捷的產品文檔撰寫工具,可以簡化產品文檔撰寫流程,提升產品經理的文檔撰寫能力,讓產品經理事半功倍。

總結

產品需求文檔作為產品開發團隊的重要溝通文檔,文檔的質量好壞會直接影響到各部門是否能夠明確產品的功能和邏輯。一份簡潔易懂、邏輯清晰的產品需求文檔,可以讓團隊溝通更加高效,從而有效提高產品開發團隊的工作效率。

『柒』 需求分析文檔的正確寫法有哪些 謝了!!

沒有什麼正確不正確,主要是為了搞明白用戶真正的要求,分析問題的解決方法,提供一個大致解決方案、思路,使大家都知道面對的是個什麼要的問題,需要如何去做;

『捌』 需求文檔怎麼寫最有效

能將功能需求寫清楚的就是好的需求文檔,因為現在的需求文檔一般都是給開發看,一般來說創業公司追求小步快跑快速迭代的開發模式的話,需求文檔不是一個很有必要的東西,直接在原型上表述效率會更好。如果公司追求規范管理的話,建議還是需求文檔,寫清楚項目名稱,迭代版本,及相關的日期規劃。

『玖』 怎樣才能寫好項目需求文檔

要想寫好項目需求文檔就必須深入客戶,了解他們的真正需求,多和客戶溝通,尤其是跟軟體項目的直接操作者溝通,看他們有什麼樣的需求,他們想怎麼用這個軟體項目,這些都很關鍵,有的時候還需要你長期在客戶那裡實習,進一步了解客戶的真正需求,把投資風險降到最低。收集好資料後就需要自己多整理,從中發現客戶沒有提出的需求,整理成需求說明文檔!

『拾』 如何寫互聯網產品需求文檔

你好,網上有很多產品需求文檔的例子,你可以參考一下,大致有以下這些內容:

首先自己要能理解需求,知道具體是要做一個什麼樣的產品,產品的主要用戶是誰,產品有哪些主要的功能
然後你能把這個需求描述給團隊其他成員,讓他們也能明白這個需求
最後在和團隊其他成員溝通的過程中你能解決他們提出的一些問題
產品背景、需求描述、關鍵詞/字、功能結構、功能流程圖、頁面流轉圖等