手把手教你寫交互設計文檔

159 評論 317829 瀏覽 1403 收藏 21 分鐘

離開交互圈已經有段時間了。但由于博客還在,還是能夠偶爾收到一些郵件,上周有位同學問我:我在求職,我看到很多招聘說明上需要交互設計師編寫界面交互設計文檔,請問界面交互設計文檔是什么文檔?怎么編寫呢

這讓我想起來2009年自己在項目里也大力推行過交互說明文檔(在下文中,簡稱為DRD),格式倒沒什么限制,交互設計師自己寫到界面上也行,單獨文檔成文也行,總之就是讓交互設計師能夠將界面承載不了的信息通過文檔沉淀下來,降低項目里的溝通成本和風險。今天整理電腦,翻出以前的PPT,分享之。這將涉及到幾個問題:

10031L342-11

一. 什么是交互說明文檔(DRD)?

所謂DRD即是用來承載交互說明,并交付給前端、測試以及開發(fā)工程師參考的文檔。

在項目中,交互設計師的主要產出物可能依次是:site map,page flow,wireframes。有的大型項目前期,交互設計師有可能還會產出用戶需求分析文檔(與PD產出的市場需求文檔不一樣的是,URD更多側重于對目標用戶的需求分析)。

DRD則很少有人專門撰寫。如果需要對交互設計進行說明,聰明的交互設計師往往會直接標注在線框圖里,或者在項目中不斷和前端工程師和開發(fā)工程師口口相傳,反復驗收,不斷迭代修改來確保所有的交互設計意圖最終得以呈現。

二. 為什么要寫?

DRD非項目必需環(huán)節(jié),一般情況下也不會為交互設計師專門留出相應的時間預估。沒有這份文檔,項目也會繼續(xù),但是可能項目會為此承擔不必要的溝通成本和時間成本。嚴重的話,項目的質量也會受到影響。所以寫與不寫,交互設計師需要做把握,時間被統(tǒng)一包含在“線框圖”環(huán)節(jié)內——如果你要寫,請在評估時預留1-2天的時間。

那么,結合我過去的經歷,談一下此文檔的必要性。

下圖是一個產品開發(fā)項目基本的流程。

10031K4E-21

敏捷開發(fā)意味著很多不同角色的流程需要并行操作。如果等到產品經理的FRD已經全部敲定,交互設計師再開始去畫線框圖,固然會減少溝通成本和返工風險,但是同時意味著交互設計師的很多想法不被采納。如果產品經理再強一些,他甚至會在FRD里連原始的DEMO也一并繪制出來了,功能性的需求和界面交互的需求有時無法區(qū)分太清楚——比如他會在FRD里直接要求每頁條目40條,超過40條即分頁。而交互設計師可能會認為像蘑菇街那樣不斷裝載出足夠長的頁面會更親和……所以,我們希望是和產品經理同時開始工作,在術業(yè)有專攻的時候相互補充。

同樣,開發(fā)工程師也希望及早介入需求,在FRD并未確認的時候就了解需求,進而將商業(yè)需求和功能需求轉化為開發(fā)工程師看得明白的開發(fā)需求清單(這個清單,大部分叫做UC,即USE CASE),當這份清單由工程師需求分析師——在過去,這個角色被叫簡稱為RA,但是目前已經取消此專門的職位,而是由開發(fā)工程師代表擔綱此環(huán)節(jié)工作,為了便于描述,在此文里,我仍然將做這件事情的人稱為RA——交付給具體的執(zhí)行工程師后,執(zhí)行工程師基本上可以當作一條條的checklist開始高效工作,而不必再思考商業(yè)邏輯和需求。同樣,測試工程師也需要編寫具體的文檔去指導很多測試人員在開發(fā)后高效測試,這也是基于UC和FRD去撰寫的。

所以,開發(fā)需求分析是個很重要的環(huán)節(jié)。那RA是如何來完成需求分析工作的呢?

  • 前期介入,對PD進行開發(fā)需求評估支持;
  • 如何寫一份交互說明文檔參與每次的FRD評審會;
  • 詳細審閱FRD文檔并不斷與PD確認。

對于做這件事情的人來說,足夠詳盡的FRD是非常重要的。所以一份FRD雖然是PD產出,但是很多實施細節(jié)則是由開發(fā)工程師不斷溝通評估并確認下來的。而設計需求的傳遞,卻存在很多問題。除了線框圖,沒有“詳盡的說明性的文檔”告訴他們。比如:

10031J257-31

一方面,交互設計師對產品經理說:這塊由我們來考慮,你的文檔不必包含設計上的說明,這隨時會調整的。

另一方面,線框圖的評審有時會讓RA參與,有時卻沒有叫他們。即使叫上了他們,他們也會發(fā)現交互設計的需求變化要比FRD變化快。另外,他們會認為UC不必寫太多關于交互設計的需求。

在某個大型項目結束后,作為交互設計師,我進行了一些調研,聽聽這相關人員是怎么表述問題的:

開發(fā)部門的需求分析師:

  • 每次變動都很痛苦,設計變了之后,我就要跟著改UC,改截圖,有時候UED改了還忘了通知我們,導致UC有問題……
  • 頁面交互的需求容易漏掉,因為UC里面不可能寫太多交互方面的東西。
  • 希望UED能夠在提交HTML DEMO給RA時,能同時給出一份頁面元素描述文檔,需要介紹html demo中的文案、鏈接以及相關的圖片尺寸或顯示字符個數。現在RA在這方面花費的時間比較多,經常要和UED去確認這些內容。

產品經理:

  • 前期RA和PD溝通過程中,有很多交互點點不能夠明確,比如“默認顯示多少屬性值”,“標題顯示多少字符”等。在以往的需求和項目中,對待這些問題我們都是想到一點補一點的到FRD文檔或者郵件中去。既增加了溝通成本又會存在遺漏細節(jié)的風險。PD為了可控性的需求,往往會“越俎代庖”,直接在FRD注明這種需求(對于交互設計師來講,卻又導致沒有發(fā)揮余地)

走訪了一些交互設計師后,他們也存在如何清晰無遺漏將交互設計需求傳遞下去的困惑:

交互認為很平常的設計需求,如果不表達出來,還是容易被前端和開發(fā)忽略掉。我經歷的一個項目,前端從頭到尾更換了三個人,每次我都要重復去講解下設計需求,講得口干舌燥。而且做好后,還需要去驗收。

  • DRD做為參考手冊,一定程度上避免不吻合的問題發(fā)生。
  • 即使有問題發(fā)生,也可以作為界面驗收時的Checklist。將“我對A說,我對B說,A對B說”,轉變?yōu)椤癆和B共同參考同一份文檔”,減少溝通成本及信息不對稱。
  • 全程影響用戶體驗(一直到測試,都需要參照設計文檔)。

可是以下問題都可以通過一份DRD來解決嗎?

10031H402-41

三. 寫什么不寫什么?

10031J208-51

要明確文檔的定位,從寫什么與不寫什么開始,劃清DRD以及FRD的邊界。

不寫視覺規(guī)范規(guī)格標注

這些說明與功能實現沒有太大關系,主要是為前端做HTML的時候參考的。一般視覺設計師會在PSD里標注清楚。如圖:

10031JP6-61

不寫功能實現邏輯。

如下圖所示,作為DRD,你有必要傳達清楚Browse by category區(qū)域的設計:鏈接的可點擊性,鏈接的指向,字符與條目的數量限制等,但是具體二級類目排列是按產品數目排還是按字母排,還是人工運營,是FRD要解決的任務。

10031H923-71

那么文檔寫什么呢?

10031H913-81

舉例子說明下:

字符限制

提高空間利用率,有時網頁上的動態(tài)文字需要從數據庫里提取部分然后截斷處理。比如下圖中的標題和描述。你的DRD需要傳達清楚:1,是否要做限制?2,如果做限制的話,多少字出現截斷?截斷后是顯示為省略號還是不顯示?這個漢語設計相對簡單,如果英文單詞的話,因為是按字符,每個字符的寬度不一致,需要預估,另外還需要注明是整詞截斷還是詞間截斷。

10031HY1-91

鏈接具體化

很多網站都有對搜索結果的篩選設計(refine search),比如aliexpress搜索結果頁左側。這塊區(qū)域的交互事件是非常復雜的。

  • 類目和屬性的不同如何處理
  • 屬性以及每條屬性顯示的屬性值的條目是否有顯示上的限制?
  • 選中后,被選中的屬性值是停留在原地,方便用戶記憶,還是放到統(tǒng)一的位置,方便用戶統(tǒng)一查看?其他未被選中的屬性值是否消失?
10031L1b-101

要確保這些你設想中的復雜的交互邏輯能夠被理解被呈現,除了一頁頁的線框圖,你有必要再三讓前端工程師和開發(fā)工程師了解并達成認知一致。所以你需要將頁面上的關鍵鏈接事件標識清楚。它們有的指向無需刷新頁面的交互,有的指向你安排的并非PD安排的某個中間頁面(page flow是交互設計師的職責)

10031G349-111

交互細節(jié)說明

相信我,我很不愿意寫這些東西。我喜歡在會議室向各位涉眾演示我的線框圖,我會研究用axure制作各種動態(tài)效果,達到它足夠逼真呈現各種聯動——比如當你選擇了下拉菜單中的某項時,頁面上其他區(qū)域也發(fā)生相應的變化。可是,Axure不是全能的。即使能夠表達出來,線框圖交付出去,也不能確保其他人都能夠一一進行點擊嘗試。所以只能在會議室反復講解,在事后再三檢查并敦促修改。

但是當我嘗試用下圖對這塊小小且復雜的區(qū)域進行詳細說明后,事情變得簡單多了。所以我用節(jié)省的時間去寫了這份PPT.

10031MZ9-121

又如,你可以在這里說明任何你想要的效果。你的受眾也只需要用10分鐘時間閱讀完畢,標注出與他工作相關的重點,存檔并在遇到問題,找不到你人時隨時參考。

10031H129-131

表單的校驗

這也是一項不怎么有創(chuàng)意的事情,但是你若不事先想清楚,在項目過程中有點麻煩。寫文檔看似枯燥乏味,反過來想也是讓你自己再好好思量審核設計本身的關鍵步驟。我曾經自以為完善的交互設計方案就是在寫DRD的時候發(fā)現存在重大的紕漏,然后及時優(yōu)化的。

10031G040-141

瀏覽器的兼容性要求

你們的產品兼容所有瀏覽器簡直是夢想,但是有時出于效率的要求,我們必須戰(zhàn)略性放棄某些瀏覽器,比如IE6.:D 。 這個決定誰來做?是前端工程師還是產品經理?還是你——交互設計師?我認為決定權在交互設計師這里,但是他必須和產品經理達成一致,并與前端確認。你要求兼容的瀏覽器越多,標準越高,前端的工作量就會越大,測試的工作量甚至也會翻倍。

10031IS1-151

四. 什么時間交付呢?

Heidi的建議:盡可能與你的線框圖同時交付,如果你先交付出線框圖,在撰寫DRD的時候,極大可能會發(fā)現問題或產生優(yōu)化的想法。但是往往寫DRD至少需要1-2天的時間,你不可能讓所有下游等著你的工作。所以:

  • 你可以交付出線框圖供視覺先開始。視覺設計往往會先做風格定位設計,這和交互細節(jié)關系不大。
  • 先交付出已經確定的線框圖給前端,然后在1-2天DRD后,若有改動,與前端當面一一確認并一起交付。

五. 如何寫DRD?

選擇最有效率的工具。

我的經驗是這個工具最好能夠提供清晰的目錄導航結構,而且易標注。word確實是個寫文檔的好工具,不管你信不信,反正我是信了。

10031K408-161

建立固定的目錄結構

下圖僅供參考。

10031K3N-171

具體里面的細節(jié),就不一一羅嗦了。

六. 重要的原則

準備寫DRD的朋友,請認識清楚此文檔真正要解決的問題是什么?如果是解決溝通偏差、需求遺漏、溝通成本高的問題,你在項目里沒有出現過這種問題,各合作方也反饋良好,那么這個文檔就無需寫。如果是解決對設計需求進行存檔,便于后續(xù)人員改版時查看的問題,則又是另外一回事(經驗證明,過去的DRD確實能夠在改版時起到一定的幫助,在我離開原項目很久后,新的設計師還找我要過相應項目的文檔,了解過去的設計邏輯)。

  • 不是為了寫文檔而寫文檔(而是為了解決問題)
  • 適合于項目、合作方(大項目有大文檔,小需求有靈巧的解決方案)
  • 工具不是問題(易傳播,易標注,成目錄即可)
  • 模版不是問題,大家看明白就可
  • 完美的文檔無法取代面對面的溝通(評審會和討論不會因為文檔而減少)
  • 需要在實踐中不斷改進

七. 誰來寫?

10031G5W-181

我建議由交互設計師發(fā)起,但是由前端工程師進行修訂,再傳遞給開發(fā)工程師。

有很多需求,交互設計師只要求實現即可,但是他可能并不在乎是前端實現還是后端實現。前端工程師對DRD進行把關和修訂,能夠將設計語言轉化為工程師能夠看懂的語言,且能夠劃定與開發(fā)的實現邊界。

八. 與其他產出物的關系

項目中交付物對應不同的使用角色,如下圖所示:

10031J315-191

但是有個問題是,雖然DRD的目標受眾有開發(fā)和測試,但是讓開發(fā)工程師同時參考那么多文檔是不現實的,所以仍然是開發(fā)工程師的接口人,也就是事實上的RA需求分析作為需求整合傳遞的角色,將商業(yè)需求和設計需求,傳達給具體的執(zhí)行開發(fā)工程師與測試工程師:

10031G423-201

【總結】

對于堅持撰寫DRD的我來說,DRD的好處自己當然是明白的——在撰寫過程中重新梳理設計邏輯,優(yōu)化設計;降低溝通成本等等。

但是并非所有人都喜歡寫文檔或者都喜歡看文檔。

解決問題有多種方案,DRD只是其中一個。不過,當你因為設計需求傳遞過程中發(fā)生了問題,或者你的需求被理解偏差,或者你的需求被遺漏,或者你接手的項目改版,因為要梳理過去的設計邏輯焦頭爛額時,你可以試試用DRD。如果使用過程中還是存在問題,那么就想想是否還存在別的解決方案吧~

 

作者:heidixie

來源:http://heidixie.lofter.com/post/b8226_168d4b5

更多精彩內容,請關注人人都是產品經理微信公眾號或下載App
評論
評論請登錄
  1. 曹老師,我是產品新手小白,希望能得到大神的一份DRD文檔參考學習,郵箱:371129848@qq,煩請分享一份,謝謝!

    來自上海 回復
  2. 曹老師,我之前也寫過,感覺無從下手,看了您的文章覺得很詳細,能否發(fā)一份DRD供參考,2997004845@qq.com,謝謝??

    來自四川 回復
  3. 老師,可以發(fā)一份DRD文檔借鑒一下嗎?郵箱2547297101@qq.com

    來自云南 回復
  4. 老師,你好看了這篇文章后很想要一份,可以發(fā)一份完整的DRD文檔嗎。麻煩您了。郵箱:21681772@qq.com

    來自湖南 回復
  5. 老師,求一份DRD文檔參考學習一下好嗎?謝謝!1369437518@qq.com

    來自山東 回復
  6. 老師,可以發(fā)一份DRD文檔給我參考一下下嗎?先謝謝了,我的郵箱719851675@qq.com

    來自北京 回復
  7. 老師,可以發(fā)一份DRD文檔給我參考一下下嗎?先謝謝了,我的郵箱15614206024@163.com

    來自河南 回復
  8. 老師求一份學習,謝謝!785343427@qq.com

    來自上海 回復
  9. 老師求一份學習,75847712@qq.com

    回復
  10. 老師,能不能給我一份完整的DRD文檔,3191238343@qq.com。謝謝老師您了!

    來自浙江 回復
  11. 求一份文檔,非常感謝,329918826@qq.com

    來自北京 回復
  12. 曹老師,我之前也寫過,感覺無從下手,看了您的文章覺得很詳細,能否發(fā)一份DRD供參考,814078352@qq.com,謝謝??

    回復
  13. @曹老師,可以發(fā)一份DRD文檔借鑒一下嗎?郵箱1636835063@qq.com,灰常感謝。

    來自廣東 回復
  14. 謝謝大神分享,能否發(fā)一份DRD文檔參考嗎,郵箱:3154707391@qq.com,感謝

    來自河南 回復
  15. 看了您的文章受益良多,您有空的時候方便也給我發(fā)一份DRD文檔參考嗎,郵箱727668991@qq.com

    來自北京 回復
  16. 謝謝大神分享,能否發(fā)一份DRD文檔參考嗎,郵箱:408783256@qq.com,感謝

    來自福建 回復
  17. 謝謝大神分享,能否發(fā)一份DRD文檔參考嗎,郵箱:420349543@qq.com,感謝 ??

    來自四川 回復
  18. 曹老師,可以發(fā)一份DRD文檔給我參考一下嗎?先謝謝了,我的郵箱455069706@qq.com ??

    來自廣東 回復
  19. 大神,跪求一份DRD文檔用于參考,郵箱:1059293653@qq.com

    來自北京 回復
  20. 很高興拜讀老師的文章,受益匪淺!
    如有詳盡的DRD文檔可發(fā)學生我參考一下嗎? 我郵箱是:13854690@qq.com

    來自廣東 回復
  21. 對于產品新手來說受益無窮,希望能得到一份DRD模版文檔學習學習,煩請分享一份592619476@qq.com,感激不盡

    來自安徽 回復
  22. 老師,麻煩您給我發(fā)一份較詳盡的DRD
    文檔,好對比學習,彌補不足,謝謝。
    我的郵箱~2847951902@qq.com

    回復
  23. 大神,可以發(fā)一份DRD文檔給我參考一下嗎?
    我的郵箱825325740@qq.com,謝謝!

    來自廣東 回復
  24. 寫了,但是測試、開發(fā)不一定會看

    來自北京 回復
  25. 大師,可以發(fā)一份DRD文檔給我參考一下嗎?
    我的郵箱157052747@qq.com,謝謝!

    來自福建 回復
  26. 大大,可以發(fā)一份DRD文檔參考下么,郵箱:280982578@qq.com

    來自湖北 回復
  27. 謝謝老師的分享,漲知識了,能否發(fā)一份DRD完整的文檔呢。郵箱:2337751353@qq.com

    來自湖北 回復
  28. 親耐的老師,可以也給我發(fā)一份DRD文檔給我參考一下嗎?
    郵箱806901425@qq.com,謝謝!

    來自河南 回復
  29. 大師,可以發(fā)一份DRD文檔給我參考一下嗎?
    我的郵箱122410179@qq.com,謝謝!
    om

    來自廣東 回復
  30. 老師,可以發(fā)一份DRD文檔借鑒一下嗎?郵箱196464069@qq.com,灰常感謝。

    來自廣西 回復