清單式提問簡介

“求助！我的軟件老閃退?！?“------具體問題出在哪個步驟？”

如何一次性明確需求，快速獲得他人幫助？四步極簡教程，助你習(xí)得極客社區(qū) GitHub 優(yōu)雅提問。 第一步：異步溝通

你可以把 GitHub 當(dāng)成一個主題討論平臺。如何實現(xiàn)？用 GitHub issue 就好——你可以在 GitHub Issues 發(fā)起議題，或參與已有議題。

GitHub Issues 的交流特點是：異步溝通。

什么叫異步溝通？ 不妨先來了解同步溝通。

同步溝通：一方發(fā)出的信息，必須等待另一方反饋后，才能繼續(xù)通訊。也就是說，雙方在沒有相互明確彼此意思前，談話是被阻塞的，只能進(jìn)行多次反復(fù)確認(rèn)，才能繼續(xù)。同步溝通很像我們平時的面對面交談，也成為主流的在線溝通形式。常見的有微信、QQ 等即時通訊工具。

同步溝通，往往要求雙方同時在線，才能跟上討論的進(jìn)展，它的弊端是：容易被不了解情況的人撕裂討論線索。如何解決這個問題？工程師們采用了異步溝通：GitHub Issues（議題）或郵件列表。

異步溝通：所有人的意見或見解，都可以通過 GitHub Issues 頁面或郵件追查、對比、反復(fù)理解，任何中途介入的人，也都可以通過 Issues 頁面全面客觀地知曉所有人的觀點。再復(fù)雜的問題，通過 GitHub Issues 都可以優(yōu)雅地、非時間強占式地，達(dá)成共識。

第二步：提問技巧

無論你用 Issues 來提問什么問題，都別忘了這三個技巧：

1. 一個 issue 只討論一個問題

一個 issue 發(fā)布多個問題，比如 title 為「2w 課程疑問」的 issue 下有五六個當(dāng)周疑問，相較一個 issue 只討論一個問題，你覺得哪個 issue 更便于展開討論、追蹤和后期歸檔？

2. 標(biāo)題力求簡短準(zhǔn)確地描述問題

例如「寫作實踐中遇到的一些問題」 VS 「如何利用積累的卡片寫出一篇文章？」 ，你更傾向點開哪個 issue 參與討論？

3. 提問內(nèi)容使用「絕對坐標(biāo)」

數(shù)學(xué)術(shù)語中，把結(jié)合情境的表達(dá)稱為「相對坐標(biāo)」，不結(jié)合情境的表達(dá)稱為「絕對坐標(biāo)」。在 Issues 描述問題細(xì)節(jié)時，請使用絕對坐標(biāo)溝通：假設(shè)每個與你溝通的都是陌生人，你需要交代清楚背景，并簡練地將事情給說明白。

反之，什么是相對坐標(biāo)？想象一個畫面：

深夜，一休回家后仍在辛勤工作，在測試 app 時，發(fā)現(xiàn)了隱藏的新問題?！癮pp 出問題啦！” 一休在工作群快速反饋。

猜猜看，網(wǎng)絡(luò)另一端的 IT 同事，能否明白一休說的是什么問題嗎？

如果同事正好在一休身邊，在聽到“app 出問題啦”后過來看一眼屏幕，馬上就能明白情況。但此時此刻，單純說“app 出問題啦”，對迅速解決問題的幫助，遠(yuǎn)不如”在 app 的 xx 界面點擊 xx 按鈕之后，app 出現(xiàn)閃退”。后者既能幫助 IT 同事迅速定位問題，也方便其他同事知曉情況。

第三步：提問示范

這是 Github 上流行的一個庫 FreeCodeCamp ，先看看這第一位同學(xué)的提問，這也是多數(shù)小白習(xí)慣的提問：

再看看第二位同學(xué)的提問，這是個網(wǎng)絡(luò)素養(yǎng)更好的提問。

兩人同在 Issue 中提問，但結(jié)果不一樣，這是為什么？因為第二位同學(xué)清楚闡述了如下要點：

結(jié)果是，同第一位無人問津的小白相比，第二位同學(xué)得到了 89 人的幫助。

第四步：結(jié)束提問

GitHub Issues 相較常見 BBS、論壇最大的區(qū)別是它可以 Close 和 Reopen 。如果你發(fā)起的議題已經(jīng)討論完畢，請及時回復(fù)（comment）最新進(jìn)展/解決方案到這個 issue 下并 Close issue，有始有終，讓協(xié)作者知道這個議題已完成；同時保持主界面清爽。

當(dāng)然，close Issue 不僅僅是點擊 close ，請在 comment 中附上相關(guān)鏈接，以便他人繼續(xù)追蹤:

Issue close 后，若再需開啟，可以 reopen ，同時最好說明原因，以便看到 Issue 的同伴迅速進(jìn)入狀態(tài)，開始共創(chuàng)。■

習(xí)得優(yōu)雅提問， 體驗異步溝通樂趣

入門信息分析，開啟 GitHub 學(xué)習(xí)之旅