如何打造高效協(xié)同的交互文檔?

20 評(píng)論 17243 瀏覽 175 收藏 28 分鐘

正式開(kāi)始閱讀前,我必須要告知親愛(ài)的讀者朋友們,此文是我工作以來(lái)的一些經(jīng)驗(yàn)總結(jié)和對(duì)工具的使用體驗(yàn),不代表這就是交互文檔的寫(xiě)作范式,交互文檔可以根據(jù)自己公司和團(tuán)隊(duì)的需求進(jìn)行寫(xiě)作,我在這里僅分享一下我的經(jīng)驗(yàn)。

Axure和藍(lán)湖是我平常工作中最常用的兩個(gè)軟件,一個(gè)是設(shè)計(jì)生產(chǎn)力工具,一個(gè)是在線協(xié)同工具,兩者搭配干活不累。

一、前言

本文分為兩部分,第一部分是分享我個(gè)人在工作中如何用Axure 制作交互文檔,第二部分是如何用藍(lán)湖與產(chǎn)品經(jīng)理、視覺(jué)設(shè)計(jì)師、客戶、以及運(yùn)營(yíng)等其他人協(xié)同。

本文基于個(gè)人有限的工作經(jīng)驗(yàn)和知識(shí)積累,若有不足之處,請(qǐng)多多擔(dān)待,若有錯(cuò)誤,敬請(qǐng)指出,互相學(xué)習(xí)交流,感謝閱讀。

二、如何輸出規(guī)范的交互文檔

1. 分清產(chǎn)品需求的層級(jí),部分更新和正式產(chǎn)品

在撰寫(xiě)文檔的時(shí)候,你應(yīng)該知道此次的需求是一個(gè)完整的項(xiàng)目,還是對(duì)已有項(xiàng)目的完善和優(yōu)化,如果是一個(gè)新的項(xiàng)目,那你需要在文檔中描述產(chǎn)品介紹,并且用簡(jiǎn)短的語(yǔ)句描述出產(chǎn)品功能和目標(biāo)用戶,但是如果是更新和優(yōu)化,則只需要描述項(xiàng)目名稱和更新的功能概要就好。

2. 交互文檔的要素

(1)文檔說(shuō)明(版本說(shuō)明、使用平臺(tái))

文檔說(shuō)明是相當(dāng)于文檔的封面,文檔說(shuō)明中應(yīng)該簡(jiǎn)短的介紹該文檔涉及的產(chǎn)品、平臺(tái)、版本以及參與人員。

(2)更新日志

更新日志是一個(gè)文檔中必不可少的部分,更新日志包含了一個(gè)項(xiàng)目從第一個(gè)版本開(kāi)始到截止開(kāi)發(fā)上線的最后一個(gè)版本的概要,方便自己和其他協(xié)作人員能快速找到優(yōu)化的部分是在哪一次的文檔中增加、刪除或者優(yōu)化的,我自己制作的更新日志頁(yè)面,包含以下幾個(gè)基本要素:

時(shí)間:時(shí)間是指該文檔經(jīng)過(guò)優(yōu)化以后,上傳至協(xié)作平臺(tái)(比如藍(lán)湖)的時(shí)間,可以明確文檔變更的具體時(shí)間。

更新內(nèi)容:更新內(nèi)容是指將文檔變更的功能點(diǎn)一一列出,分別用文字作簡(jiǎn)單的描述,更新內(nèi)容是更新日志中非常重要的一環(huán),如果沒(méi)有文字的說(shuō)明,那么回溯文檔版本的時(shí)候,就沒(méi)法進(jìn)行快速的檢查和瀏覽了,對(duì)于后期維護(hù)將是一場(chǎng)災(zāi)難。

更新頁(yè)面:更新頁(yè)面是指將更新的內(nèi)容分別對(duì)應(yīng)不同的交互頁(yè)面,有助于開(kāi)發(fā)或者其他小伙伴快速準(zhǔn)確的找到更新內(nèi)容,開(kāi)發(fā)沒(méi)時(shí)間一一翻閱大量的文檔,因此版本更新只需要告訴他們哪里改變了即可。

更新類型:更新類型分為三種:新增/刪除/優(yōu)化。我將每一次的版本更新打上不同的標(biāo)簽,該標(biāo)簽可以更加直觀的說(shuō)明當(dāng)前版本更新的類型是新增還是優(yōu)化。

另外可以根據(jù)自己的需求增加修改人、版本號(hào)等要素,由于在實(shí)際項(xiàng)目中,只有我一個(gè)人在維護(hù)文檔,再加上做SaaS版本規(guī)劃不是很明確,我的文檔中就不涉及這兩點(diǎn)。

(3)閱前須知

閱前須知是指文檔的使用者在閱讀之前應(yīng)該要瀏覽的注意事項(xiàng),否則無(wú)法理解文檔中的一些特殊示意。閱前須知我分為以下兩種:

1)通用標(biāo)識(shí)說(shuō)明

通用標(biāo)識(shí)說(shuō)明是指在整個(gè)文檔中廣泛存在的標(biāo)識(shí)元素進(jìn)行說(shuō)明,幫助閱讀者快速了解文檔的專用標(biāo)識(shí)和術(shù)語(yǔ)。

2)通用組件說(shuō)明

通用組件說(shuō)明是指在開(kāi)發(fā)一個(gè)全新的產(chǎn)品時(shí),建立的一套簡(jiǎn)化版的設(shè)計(jì)規(guī)范,該設(shè)計(jì)規(guī)范指定了當(dāng)前文檔中一些組件的樣式、交互以及特殊情況。

(4)結(jié)構(gòu)圖、流程圖、思維導(dǎo)圖

1)結(jié)構(gòu)圖

一般我在文檔全部更新完畢上傳的時(shí)候,會(huì)用Axure的生成流程圖功能將全部的頁(yè)面生成一個(gè)樹(shù)形的結(jié)構(gòu)圖,點(diǎn)擊結(jié)構(gòu)圖中的模塊可以很方便的跳轉(zhuǎn)至相應(yīng)的頁(yè)面,這樣開(kāi)發(fā)在查看文檔的時(shí)候不用一個(gè)個(gè)去翻閱文檔,可以直接打開(kāi)文檔結(jié)構(gòu)頁(yè)面,整個(gè)文檔的結(jié)構(gòu)一目了然,點(diǎn)擊模塊就可以直接跳轉(zhuǎn)至相應(yīng)的頁(yè)面,方便又快速。

2)流程圖

流程圖是指業(yè)務(wù)相關(guān)的流程圖,將業(yè)務(wù)邏輯用流程圖進(jìn)行描述,一般對(duì)于復(fù)雜業(yè)務(wù),才會(huì)用這個(gè)梳理邏輯,流程圖不但有利于自己構(gòu)建完善的業(yè)務(wù)流程,同時(shí)也有利于開(kāi)發(fā)梳理業(yè)務(wù)的邏輯。

3)思維導(dǎo)圖

思維導(dǎo)圖是根據(jù)文檔的需要將產(chǎn)品的功能用思維導(dǎo)圖的形式羅列出來(lái),開(kāi)發(fā)可以窮盡每一個(gè)類目下面的子級(jí),從而獲得一個(gè)完整的結(jié)構(gòu)。

以上三種都是輔助文檔使用者和撰寫(xiě)者理解文檔的圖示,因此是非必須的,可以根據(jù)業(yè)務(wù)的需求進(jìn)行繪制相關(guān)的圖示,Axure本身沒(méi)有對(duì)流程圖和思維導(dǎo)圖有很好的支持,因此你只需要在第三方軟件做好圖以后,復(fù)制到Axure界面即可。

(5)交互頁(yè)面

交互頁(yè)面是整個(gè)文檔中最重要的一部分了,也是整個(gè)文檔的主體,每個(gè)行業(yè)每個(gè)產(chǎn)品的交互文檔都不一樣,“形而上者謂之道”,盡管各有不同,但是也能總結(jié)一些通用的規(guī)范:

1)文檔結(jié)構(gòu)要清晰合理

交互文檔的層級(jí)劃分清晰明確,通過(guò)產(chǎn)品的結(jié)構(gòu)進(jìn)行頁(yè)面的劃分,分清頁(yè)面的主次。

2)用詞準(zhǔn)確且無(wú)歧義

首先,在對(duì)文檔進(jìn)行描述的時(shí)候,用詞一定要準(zhǔn)確無(wú)歧義,如果專業(yè)術(shù)語(yǔ)解釋不清楚,可在后面舉個(gè)例子,你的文檔的目的是讓閱讀的人能看懂,無(wú)論他是開(kāi)發(fā)還是產(chǎn)品,因此用通俗的語(yǔ)言描述你的文檔,適當(dāng)?shù)臅r(shí)候舉例子進(jìn)行補(bǔ)充說(shuō)明。

其次,你的文檔對(duì)應(yīng)的產(chǎn)品目標(biāo)用戶,是否能理解你的描述也很重要,舉個(gè)例子:在后臺(tái)產(chǎn)品中,使用者并不一定是知識(shí)水平非常高的人,如果你用”閾值”等專業(yè)術(shù)語(yǔ)并不加解釋的話,用戶很難去理解產(chǎn)品的功能。

3)流程完善且無(wú)缺漏

一般來(lái)說(shuō),交互文檔在交付的時(shí)候總會(huì)因?yàn)楦鞣N原因而有所遺漏,要么是因?yàn)椴皇煜I(yè)務(wù)而導(dǎo)致部分功能沒(méi)有涉及到,要么是因?yàn)椴涣私饧夹g(shù)而缺失了某些特殊場(chǎng)景。在這個(gè)時(shí)候,我們需要通過(guò)交互走查和評(píng)審來(lái)發(fā)現(xiàn)相關(guān)的問(wèn)題,走查是撰寫(xiě)者自己對(duì)照走查表梳理頁(yè)面的缺漏,評(píng)審則是通過(guò)他人的角度來(lái)發(fā)現(xiàn)問(wèn)題,因此一個(gè)好的流程是不斷迭代和完善的,你需要做的就是盡可能將交互文檔做的完善且無(wú)缺漏。

4)文檔模擬數(shù)據(jù)盡量還原真實(shí)數(shù)據(jù)

很多人在設(shè)計(jì)的時(shí)候,都會(huì)填充大量的模擬數(shù)據(jù)用以支撐頁(yè)面的內(nèi)容,sketch有很多自動(dòng)填充的插件,比如頭像、圖片、文本、姓名甚至是地址等,這樣的插件方便了我們的工作,但是有些時(shí)候文本的填充并不會(huì)貼合我們的業(yè)務(wù),甚至可能完全無(wú)關(guān)。

但是Axure沒(méi)有這樣的插件,因此在設(shè)計(jì)的時(shí)候,我們盡量去還原真實(shí)的場(chǎng)景,比如商品名稱,就寫(xiě)真實(shí)的商品名稱,地址就寫(xiě)真實(shí)的地址,如果你填充的是毫無(wú)邏輯的文本,那么閱讀者在主觀上很難融入產(chǎn)品的使用場(chǎng)景。

當(dāng)然,每條數(shù)據(jù)都用不同的真實(shí)文本填充將會(huì)耗費(fèi)我們大量的時(shí)間,你也可以采取一些比較討巧的方式,比如,一個(gè)列表,第一行用真實(shí)文本,其余的都復(fù)制第一行的即可,但是如果涉及到不同的狀態(tài),還是要加以區(qū)分并說(shuō)明。

5)極限情況和缺省狀態(tài)要注意

很多新手可能經(jīng)常會(huì)被開(kāi)發(fā)問(wèn):”這個(gè)文本框字符最多可以填多少個(gè)?“,這是由于對(duì)極限值沒(méi)有在文檔中進(jìn)行說(shuō)明而造成的疑問(wèn),除了指定”最多“情況,也需要指定”最少“的情況。

那么問(wèn)題來(lái)了,我們?cè)撊绾稳ヅ袛嘤脩魬?yīng)該輸入的字符范圍呢?首先,這是由兩個(gè)因素決定的。

第一個(gè)因素,所輸入的字段,在通用的業(yè)務(wù)場(chǎng)景下,一般都是多少個(gè)字符,比如商品名稱,我們可以去查看下淘寶等平臺(tái)的商品名稱,再結(jié)合我們的業(yè)務(wù)進(jìn)行字段的限制。

第二個(gè)因素,所輸入的字段,在你的業(yè)務(wù)場(chǎng)景下,顯示在什么區(qū)域,該區(qū)域允許顯示的字符是多少。如果你的前臺(tái)列表頁(yè)中只給該字段預(yù)留了一行,那么你應(yīng)該在視覺(jué)上判斷下大致需要顯示的字符數(shù)量,如果只能顯示一行,那么就要設(shè)定截?cái)嘁?guī)則,一般都用”…“代替,在點(diǎn)開(kāi)詳情頁(yè)的時(shí)候顯示全部的字符。

類似的極限情況太多了,比如斷網(wǎng)情況、流程中斷、數(shù)量范圍等,業(yè)務(wù)、場(chǎng)景不同,極限情況也不同,在這里就不一一枚舉了。

另外一個(gè)需要注意的就是缺省狀態(tài),即默認(rèn)狀態(tài)。我們?cè)谠O(shè)計(jì)界面的時(shí)候,是在設(shè)計(jì)一個(gè)頁(yè)面內(nèi)容滿載的狀態(tài),而非一個(gè)產(chǎn)品的初始狀態(tài),如果設(shè)計(jì)初始狀態(tài),那么我們的設(shè)計(jì)稿就一片空白了,因此我們?cè)谠O(shè)計(jì)完產(chǎn)品的時(shí)候,也需要梳理下頁(yè)面的缺省狀態(tài),比如個(gè)人中心的訂單沒(méi)有訂單的情況,后臺(tái)商品列表中沒(méi)有商品的情況,以及查詢?yōu)榭盏臓顟B(tài)等。

6)文檔標(biāo)注需要清晰且明確

在交互文檔中,除了交互頁(yè)面的設(shè)計(jì),其中最重要的就是標(biāo)注說(shuō)明了,很大一部分的操作交互除了直觀的界面展示以外,就是通過(guò)標(biāo)注說(shuō)明來(lái)闡釋的,在我的工作流程中,我將其分為了四個(gè)類型:全局說(shuō)明、帶標(biāo)記線的說(shuō)明局部說(shuō)明以及交互說(shuō)明,分別是針對(duì)整個(gè)頁(yè)面的說(shuō)明、帶有視覺(jué)引導(dǎo)的說(shuō)明、局部功能的提示性說(shuō)明以及操作說(shuō)明。可以很好的使開(kāi)發(fā)能夠迅速準(zhǔn)確的定位并理解標(biāo)注內(nèi)容。

7)第三視角看文檔

把自己當(dāng)成該文檔的使用者,把自己當(dāng)成該產(chǎn)品的用戶,把自己當(dāng)成該文檔的審核人,通過(guò)這個(gè)角度,你會(huì)明白那些地方用語(yǔ)不太明確,邏輯有些混亂,在對(duì)頁(yè)面進(jìn)行窮盡式梳理的時(shí)候,盡量別偷懶,把你能想到的情況都一一說(shuō)明。

(6)文檔附件

交互文檔存在的意義是將產(chǎn)品需求用可視化的線框圖展示給相關(guān)人員,因此需要輔助的文檔來(lái)完善整個(gè)文檔的功能。這些文檔附件包括且不限于導(dǎo)出字段的表格、上傳的表格、產(chǎn)品需求表、以及用其他軟件制作的輔助文檔等,通常承載于Excel表格、Word文檔、PDF文檔以及圖片等文件中。

由于axure中并沒(méi)有可以直接上傳其他文件類型(除了圖片和文字)的功能,因此我們通常用云端協(xié)作軟件來(lái)上傳,比如藍(lán)湖的資源庫(kù)功能。通常,你需要在文檔中需要的頁(yè)面添加相關(guān)說(shuō)明,表示有相關(guān)文檔附件的存在。

(7)回收站功能

回收站是指需求變動(dòng)或者其他原因?qū)е履阕龅慕M件和頁(yè)面用不上了,需要將其整個(gè)優(yōu)化或者刪掉,但是不排除以后又會(huì)改回來(lái),你只需要將你的組件或者頁(yè)面放到回收站,標(biāo)記好相應(yīng)的名稱(為了方便下次查詢),如以后需要可直接復(fù)制到相應(yīng)的頁(yè)面。

(8)交互走查表

建立交互走查表首先需要熟悉產(chǎn)品業(yè)務(wù)邏輯,走查表是建立在產(chǎn)品功能之上,每個(gè)產(chǎn)品的交互走查表都不一樣,其中,平臺(tái)的差異是比較大的,比如,移動(dòng)端app和web平臺(tái)的差異性導(dǎo)致了其頁(yè)面實(shí)現(xiàn)的邏輯不一致,因此容易遺漏的點(diǎn)也不一致,web端是基于瀏覽器的實(shí)現(xiàn)邏輯,而app則需要根據(jù)每個(gè)平臺(tái)的差異(iOS和安卓),建立不同的走查表,但是這只是針對(duì)平臺(tái)規(guī)范的走查,主要的業(yè)務(wù)邏輯的走查都是相通的。
基礎(chǔ)邏輯走查:

業(yè)務(wù)邏輯走查:

建立走查表是一個(gè)不斷完善迭代的過(guò)程,只要不偷懶,一般都會(huì)建立一個(gè)很好的規(guī)避措施。

三、其他問(wèn)題

1. 設(shè)計(jì)組件的整理和制作

在開(kāi)始一個(gè)項(xiàng)目之前,如果是一個(gè)全新的項(xiàng)目,那我建議你為這個(gè)項(xiàng)目打造一個(gè)組件庫(kù),或許這將花費(fèi)你很多時(shí)間,但是在后續(xù)設(shè)計(jì)的時(shí)候你將會(huì)感受到它的便利性,同時(shí),建立好規(guī)范的組件庫(kù)以后,你也無(wú)需時(shí)時(shí)去查看尺寸大小等細(xì)節(jié)規(guī)范,只需要將其拖到界面合適的位置,加以改動(dòng)即可,這樣既保持了整個(gè)文檔的統(tǒng)一性,又能提高設(shè)計(jì)文檔的效率。

另外,如果你的產(chǎn)品有自己的一套設(shè)計(jì)體系,但是并沒(méi)有做成組件,我建議你還是做成一套組件引入到自己的Axure中,這將在后續(xù)的更新和維護(hù)上給你帶來(lái)巨大的方便。

同時(shí),你也可以使用第三方的設(shè)計(jì)組件,比如螞蟻金服推出的Ant Design。

2. 高保真、低保真該選哪個(gè)?

有些視覺(jué)出身的交互設(shè)計(jì)師可能糾結(jié)于交互文檔是否要做的跟設(shè)計(jì)稿一樣,增加很多的交互操作和動(dòng)態(tài)效果。關(guān)于高保真和低保真該選哪個(gè),唯一參照的依據(jù)就是,你的交互文檔使用場(chǎng)景是什么,目標(biāo)用戶是誰(shuí)。

如果你的使用場(chǎng)景是在公司內(nèi)部開(kāi)發(fā)使用,目標(biāo)用戶是和你合作的前后端開(kāi)發(fā)人員以及產(chǎn)品、UI,那么你的文檔是為了提高開(kāi)發(fā)效率而存在的,這時(shí)你不需要做成跟視覺(jué)稿一樣的,你只需要用黑白灰的線框圖做好產(chǎn)品的原型即可,這樣做的好處有四個(gè):

(1)設(shè)計(jì)效率極高,能快速完成產(chǎn)品原型設(shè)計(jì);

(2)修改方便,在原型階段,交互稿的改動(dòng)是非常頻繁的,因此如果你做的跟視覺(jué)稿一樣,加了很多交互操作,那改動(dòng)簡(jiǎn)直會(huì)要了設(shè)計(jì)師的命;

(3)適合開(kāi)發(fā)拋開(kāi)細(xì)節(jié)快速查看,頁(yè)面有很多UI元素的時(shí)候,會(huì)影響開(kāi)發(fā)(后端)梳理邏輯,因?yàn)檫@些細(xì)節(jié)會(huì)誤導(dǎo)他,更何況UI界面的元素本身是多變且不確定的,開(kāi)發(fā)在開(kāi)始時(shí)只需要梳理業(yè)務(wù)邏輯即可,至于UI,那是視覺(jué)設(shè)計(jì)稿和前端的事,在交互階段并不存在這個(gè)問(wèn)題;

(4)可以讓UI充分發(fā)揮自己的設(shè)計(jì)感,設(shè)計(jì)出更加出彩的界面。我們作為交互設(shè)計(jì)師,只需要關(guān)注頁(yè)面的交互和業(yè)務(wù)的邏輯,無(wú)需關(guān)心元素的圓角和陰影的大小。如果你的交互稿做的跟UI視覺(jué)稿一樣,會(huì)在主觀上影響UI設(shè)計(jì)師的判斷,甚至可能會(huì)引發(fā)同事之間的矛盾。

如果你的使用場(chǎng)景是項(xiàng)目演示,目標(biāo)用戶是沒(méi)有軟件開(kāi)發(fā)相關(guān)知識(shí)的老板、甲方(客戶)、測(cè)試用戶,你就需要根據(jù)你們自己的需求,建立一套可點(diǎn)擊、可跳轉(zhuǎn)的高保真原型demo,用以在項(xiàng)目演示的時(shí)候給客戶或老板進(jìn)行演示操作,給他們一個(gè)直觀生動(dòng)的印象,如果他們擁有絕大部分的決策權(quán)的話,會(huì)有很大的幾率通過(guò)方案。

因此,關(guān)于高保真和低保真的爭(zhēng)論沒(méi)有必要,選擇哪一個(gè)完全看交互原型的使用場(chǎng)景和目標(biāo)用戶。就我個(gè)人來(lái)講,一般工作場(chǎng)景下,我是不建議將交互文檔做成視覺(jué)稿的!

四、Axure+藍(lán)湖打造產(chǎn)品開(kāi)發(fā)協(xié)同工具

1. Axure 上傳至藍(lán)湖,建立好文檔

在藍(lán)湖建立好相應(yīng)的項(xiàng)目,拉入相關(guān)的參與人,用藍(lán)湖軟件將Axure文檔直接上傳至藍(lán)湖平臺(tái),通過(guò)其他通訊軟件告知參與各方文檔已上傳。

2. 將附件文檔上傳至資源庫(kù)

若你的交互文檔有附帶的其他類型的文檔,可以上傳至資源庫(kù),并在交互文檔的相關(guān)頁(yè)面進(jìn)行說(shuō)明。

3. 查看歷史版本功能

開(kāi)發(fā)人員在查看的時(shí)候可以點(diǎn)擊相關(guān)的歷史版本進(jìn)行對(duì)比查看,也可以快速跳轉(zhuǎn)至文檔改動(dòng)的頁(yè)面。

4. 交互文檔關(guān)聯(lián)設(shè)計(jì)稿

如果你的設(shè)計(jì)稿和交互文檔的頁(yè)面用了同一個(gè)名稱,藍(lán)湖會(huì)自動(dòng)將你的設(shè)計(jì)稿和交互稿關(guān)聯(lián)在一起,可以直接從交互稿跳轉(zhuǎn)至相應(yīng)的設(shè)計(jì)稿,這對(duì)于前端開(kāi)發(fā)來(lái)說(shuō),非常方便。但是目前沒(méi)有手動(dòng)關(guān)聯(lián)的功能,大多數(shù)情況下,自動(dòng)關(guān)聯(lián)并不是很好用,只能說(shuō)是一個(gè)有甚于無(wú)的雞肋功能了,希望后續(xù)能手動(dòng)關(guān)聯(lián)。

5. 團(tuán)隊(duì)內(nèi)部人員協(xié)同,標(biāo)記并通知

如果需要特別強(qiáng)調(diào)某個(gè)功能,可以直接在原型中添加評(píng)論并@參與人員,藍(lán)湖的標(biāo)注功能已經(jīng)很好用了,但是唯一的缺憾是,如果有改動(dòng),我無(wú)法在一個(gè)軟件中同時(shí)完成修改頁(yè)面和修改說(shuō)明的操作,因此如果在Axure中修改了頁(yè)面,再去修改藍(lán)湖中的標(biāo)注說(shuō)明,對(duì)我來(lái)說(shuō)效率太差了,因此我的標(biāo)注說(shuō)明都是做在當(dāng)前頁(yè)面中,既方便導(dǎo)出使用,也方便線上協(xié)作。

6. 用鏈接密碼分享文件原型

如果你的項(xiàng)目需要給第三方的人看,但他并不想注冊(cè)藍(lán)湖的賬號(hào),比如甲方、客戶、參與測(cè)試的用戶等,你可以將鏈接和密碼發(fā)給相關(guān)人員,方便且高效。

五、尾聲

此文到這里就告一段落,當(dāng)然一份交互文檔不僅僅包含這些內(nèi)容,根據(jù)不同的需求和業(yè)務(wù)場(chǎng)景,交互文檔的范式也不一而足。因此,總結(jié)出適合自己以及適合自己團(tuán)隊(duì)使用的交互文檔是協(xié)同的最佳方式。

在我個(gè)人看來(lái),交互文檔雖然在規(guī)范化上面臨著挑戰(zhàn),即怎樣才能輸出讓他人易于理解的文檔,但最重要的是,如何在業(yè)務(wù)需求的基礎(chǔ)上輸出合理的解決方案,達(dá)成業(yè)務(wù)需求和技術(shù)實(shí)現(xiàn)方面的平衡。

舉一個(gè)簡(jiǎn)單的例子說(shuō)明和技術(shù)溝通的重要性:之前在做一個(gè)表單相關(guān)的項(xiàng)目,后臺(tái)創(chuàng)建表單的時(shí)候,涉及到表單字段的排序,我設(shè)計(jì)的方案是表單名稱和表單簡(jiǎn)介與字段一并填寫(xiě),最后一鍵提交。

這里存在一個(gè)問(wèn)題是:

前端跟我溝通說(shuō)因?yàn)槲覀兊南到y(tǒng)中沒(méi)有這樣的交互,需要將表單保存到數(shù)據(jù)庫(kù)后在進(jìn)行上移下移操作,如果要在前端做假的上移下移,最后一鍵提交到數(shù)據(jù)庫(kù),則比較耗時(shí)耗力。

因此我們優(yōu)化了方案,分步驟填寫(xiě),首先在新建表單的時(shí)候填寫(xiě)表單名稱、表單簡(jiǎn)介,以及相應(yīng)的限制方式,保存后下一步再添加表單內(nèi)的字段,每個(gè)字段添加完畢后直接保存至數(shù)據(jù)庫(kù),上移下移也與數(shù)據(jù)庫(kù)進(jìn)行交互,最后提供給用戶一個(gè)保存按鈕和一個(gè)保存并發(fā)布按鈕,用戶可以自主選擇表單在前臺(tái)的顯示狀態(tài)。

另外,在二次編輯的時(shí)候,我們將其放在了同一個(gè)頁(yè)面,上下布局,因?yàn)榇藭r(shí),系統(tǒng)以及將表單寫(xiě)入數(shù)據(jù)庫(kù),與我們之前的交互一致。

類似的例子不勝枚舉,經(jīng)常在于開(kāi)發(fā)溝通的過(guò)程中,我也覺(jué)得懂技術(shù)的交互設(shè)計(jì)師確實(shí)會(huì)在方案落地上有優(yōu)勢(shì),但這個(gè)懂技術(shù)并不意味著你要會(huì)寫(xiě)代碼,而是你需要了解計(jì)算機(jī)是如何實(shí)現(xiàn)你的設(shè)計(jì)方案的,這又是一個(gè)冗長(zhǎng)而繁雜的話題,在此就不展開(kāi)了。

另外,如果有同學(xué)需要文中所示的交互文檔,可與我聯(lián)系,我的公眾號(hào),星野隨記,感謝您的閱讀。

 

作者:米蘭小鐵匠;公眾號(hào):星野隨記(ID:Free_mediocre)

本文由 @米蘭小鐵匠 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理,未經(jīng)許可,禁止轉(zhuǎn)載

題圖來(lái)自 Unsplash,基于 CC0 協(xié)議

更多精彩內(nèi)容,請(qǐng)關(guān)注人人都是產(chǎn)品經(jīng)理微信公眾號(hào)或下載App
評(píng)論
評(píng)論請(qǐng)登錄
  1. 關(guān)于axure的自動(dòng)填充 我使用的是Python腳本實(shí)現(xiàn),可以填充任意尺寸圖片,文字,日期等等。

    回復(fù)
    1. 哇,這個(gè)棒,大佬厲害了

      回復(fù)
  2. 很不錯(cuò)的分享~ ??

    來(lái)自北京 回復(fù)
  3. 理念很好,交互文檔相對(duì)一般。用來(lái)檢驗(yàn)我的文檔有哪些不完善的地方還是很有幫助,謝謝

    來(lái)自北京 回復(fù)
    1. 有幫助就好,感謝閱讀 ??

      來(lái)自浙江 回復(fù)
    2. 加油

      來(lái)自北京 回復(fù)
    3. 好嘞,加油!

      來(lái)自浙江 回復(fù)
  4. “藍(lán)湖會(huì)自動(dòng)將你的設(shè)計(jì)稿和交互稿關(guān)聯(lián)在一起”,這個(gè)是企業(yè)版才有的功能么?我測(cè)試后,沒(méi)有關(guān)聯(lián)的圖鑒可以點(diǎn)擊跳轉(zhuǎn)設(shè)計(jì)稿

    來(lái)自江蘇 回復(fù)
    1. 我問(wèn)過(guò)藍(lán)湖的產(chǎn)品,他說(shuō)是根據(jù)名稱關(guān)聯(lián)的,如果名稱一樣的話就會(huì)被關(guān)聯(lián),在我實(shí)際的用途中,偶爾有頁(yè)面會(huì)被關(guān)聯(lián),其他很多頁(yè)面都沒(méi)有關(guān)聯(lián),因此如果能手動(dòng)關(guān)聯(lián)的話最好不過(guò)了

      來(lái)自浙江 回復(fù)
    2. 我研究出來(lái)了,不是在設(shè)計(jì)軟件里面靠畫(huà)板名稱來(lái)關(guān)聯(lián)的,而是把設(shè)計(jì)頁(yè)面導(dǎo)入藍(lán)湖后,通過(guò)藍(lán)湖進(jìn)行分組,分組名跟交互稿名字一樣,就可以自動(dòng)關(guān)聯(lián)了,這個(gè)不需要手動(dòng)關(guān)聯(lián),會(huì)亂的,目前這樣我感覺(jué)就挺好

      來(lái)自江蘇 回復(fù)
    3. get!

      來(lái)自浙江 回復(fù)
  5. 你好,作為一名新手,需要文中所示的交互文檔參考一下,方便的話能否發(fā)到我郵箱760219443@qq.com。感謝

    來(lái)自廣東 回復(fù)
    1. 你好,https://mp.weixin.qq.com/s?__biz=MzI0NjE2MjgxOA==&mid=2247483920&idx=1&sn=448e21b8f4694a5ef013d911307e8bac&chksm=e94236fdde35bfeb60620c7f71a63acf1360641777ac955a83b32aec8453b5b566d8af149621&token=1949101340&lang=zh_CN#rd
      這篇文章的評(píng)論區(qū)有鏈接,麻煩自取下,謝謝

      來(lái)自浙江 回復(fù)
    2. 沒(méi)有看到啊

      來(lái)自廣東 回復(fù)
    3. 來(lái)自浙江 回復(fù)
    4. 謝謝

      來(lái)自廣東 回復(fù)
    5. 感謝分享,但是你的文件打不開(kāi) ??

      來(lái)自北京 回復(fù)
    6. https://pan.baidu.com/s/1t4WGeP36ZlZJ088bl4vDWg 提取碼: kx9m. 這個(gè)鏈接能打的開(kāi)的,

      來(lái)自浙江 回復(fù)
  6. 對(duì)于文檔中的新增/刪除/更新的標(biāo)識(shí),在文檔中具體怎么體現(xiàn)的 可以說(shuō)一下嗎?例如:我一期做了20個(gè)user case,二期優(yōu)化5個(gè)user case,那么其中有一個(gè)優(yōu)化的user case是一期里面有的,那么我要重新再寫(xiě)一遍呢,還是那原來(lái)的替換掉呢?希望解答!因?yàn)橐恢睂?duì)迭代文檔這有所迷惑,沒(méi)有找到很好的辦法

    回復(fù)
    1. 新增/刪除/更新的標(biāo)識(shí)是只針對(duì)更新日志的,即告訴閱讀者此次的迭代更新了那些東西,至于具體更新了什么,需要點(diǎn)擊鏈接跳轉(zhuǎn)至詳情頁(yè)面,如果我理解的沒(méi)錯(cuò)的話,你的意思是在文檔詳情頁(yè)是否需要將優(yōu)化的5個(gè) user case重新寫(xiě)或者替換?我認(rèn)為,在文檔的詳情頁(yè),不應(yīng)該保留優(yōu)化之前的信息,直接展示優(yōu)化后的即可,直接替換優(yōu)化掉的user case ,因?yàn)槲覀冊(cè)诟氯罩局幸呀?jīng)說(shuō)明了這部分有更新,閱讀者可以自行閱讀,如果保留之前的信息,反而在閱讀的時(shí)候會(huì)造成干擾。

      來(lái)自浙江 回復(fù)