[077]請認真寫下每一篇文章

背景

最近在公司wiki 上寫一些文檔室抽,對于表格中的一些內(nèi)容我有時采用簡化的語言來表達拗引。而當我回過頭去看卻不明白我需要表達的意思犀呼。

不管是自己寫日記還是工作上的文檔都需要把問題陳述清楚枣察。當我認真把工作表格中的問題表達清楚后,其他同事很容易看懂我的疑問直接用文字給我答復晰奖,而不需要向我確認是什么意思。

寫文檔就是給別人陳述一件事情

寫文檔當然費精力腥泥,在寫文檔時我們也在表述清楚和言簡意賅上平衡匾南。寫的太簡單一些基本概念沒有闡述,看的人會不明白蛔外。太啰嗦什么都去解釋一下蛆楞,寫的人比較累,看的人也會覺得很冗余夹厌。

所以需要指導讀這份文檔的人是誰豹爹,背景是什么?這樣對于大家都知道的事可以一筆帶過尊流。所以寫文檔就是在給別人陳述一件事情帅戒。

寫給自己看的順帶給別人看

通過寫博客,可以梳理出自己有哪些點不懂崖技。只要是直覺上有疑問逻住,說明你還沒有掌握,這時你需要把這種直覺上的疑問用樸實的文字表達出來迎献。

工作上的文檔時寫給別人看的瞎访,日記和博客初衷應該是寫給自己看,當然順帶有人看更好吁恍。所以我的心態(tài)是先梳理清楚自己的疑問扒秸,通過文字一步一步闡述自己的問題。寫完之后在形式和大體內(nèi)容上修正使其更便于別人閱讀包括排版和邏輯冀瓦,但這是次要的要求伴奥。

有疑問就認真寫出來

每天工作上會遇到很多問題,我會把它記錄下來翼闽。但是回來有時就忘記對其闡述和分析拾徙。
有時也會想,我先從書中看看有解決我的疑問沒感局?此時沒有寫下來的疑問是一種朦朧的狀態(tài)尼啡,當你進入書里作者的邏輯時暂衡,你對自己的問題可能忘記了。
這就需要我們帶著問題看書崖瞭,即先明白自己的問題是啥狂巢?我看這本書是為了解決我的某個疑問。所以以后看書我會先把問題以博客形式寫下來书聚。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末唧领,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子寺惫,更是在濱河造成了極大的恐慌疹吃,老刑警劉巖,帶你破解...
    沈念sama閱讀 222,252評論 6 516
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件西雀,死亡現(xiàn)場離奇詭異萨驶,居然都是意外死亡,警方通過查閱死者的電腦和手機艇肴,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,886評論 3 399
  • 文/潘曉璐 我一進店門腔呜,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人再悼,你說我怎么就攤上這事核畴。” “怎么了冲九?”我有些...
    開封第一講書人閱讀 168,814評論 0 361
  • 文/不壞的土叔 我叫張陵谤草,是天一觀的道長。 經(jīng)常有香客問我莺奸,道長丑孩,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 59,869評論 1 299
  • 正文 為了忘掉前任灭贷,我火速辦了婚禮温学,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘甚疟。我一直安慰自己仗岖,他們只是感情好,可當我...
    茶點故事閱讀 68,888評論 6 398
  • 文/花漫 我一把揭開白布览妖。 她就那樣靜靜地躺著轧拄,像睡著了一般。 火紅的嫁衣襯著肌膚如雪讽膏。 梳的紋絲不亂的頭發(fā)上紧帕,一...
    開封第一講書人閱讀 52,475評論 1 312
  • 那天,我揣著相機與錄音,去河邊找鬼是嗜。 笑死,一個胖子當著我的面吹牛挺尾,可吹牛的內(nèi)容都是我干的鹅搪。 我是一名探鬼主播,決...
    沈念sama閱讀 41,010評論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼遭铺,長吁一口氣:“原來是場噩夢啊……” “哼丽柿!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起魂挂,我...
    開封第一講書人閱讀 39,924評論 0 277
  • 序言:老撾萬榮一對情侶失蹤甫题,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后涂召,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體坠非,經(jīng)...
    沈念sama閱讀 46,469評論 1 319
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,552評論 3 342
  • 正文 我和宋清朗相戀三年果正,在試婚紗的時候發(fā)現(xiàn)自己被綠了炎码。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 40,680評論 1 353
  • 序言:一個原本活蹦亂跳的男人離奇死亡秋泳,死狀恐怖潦闲,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情迫皱,我是刑警寧澤歉闰,帶...
    沈念sama閱讀 36,362評論 5 351
  • 正文 年R本政府宣布,位于F島的核電站卓起,受9級特大地震影響和敬,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜既绩,卻給世界環(huán)境...
    茶點故事閱讀 42,037評論 3 335
  • 文/蒙蒙 一概龄、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧饲握,春花似錦私杜、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,519評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至笆怠,卻和暖如春铝耻,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,621評論 1 274
  • 我被黑心中介騙來泰國打工瓢捉, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留频丘,地道東北人。 一個月前我還...
    沈念sama閱讀 49,099評論 3 378
  • 正文 我出身青樓泡态,卻偏偏與公主長得像搂漠,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子某弦,可洞房花燭夜當晚...
    茶點故事閱讀 45,691評論 2 361

推薦閱讀更多精彩內(nèi)容

  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 172,307評論 25 707
  • 攝影大概我玩了很多年桐汤,身邊走過很多朋友。也有很多問題靶壮,在此給大家分享一下怔毛。 隨著社會的發(fā)展相機已經(jīng)是一個很普片的的...
    Tom_GT閱讀 260評論 0 1
  • 昨天是黑暗的一天拣度,遇到很多棘手的問題,身心疲憊蜂莉。 出差兩個星期蜡娶,回到家里就看到女兒在做作業(yè)。我湊過去親了她一下映穗,順...
    AllenDUAN2017閱讀 168評論 0 0
  • 每到一個地方窖张,我經(jīng)常去麥當勞德克士這樣的地方坐一坐,一杯熱橙汁經(jīng)常是必選蚁滋。等著該等的人宿接,等待該到的時間。這是個干凈...
    過路塵客閱讀 1,199評論 0 0
  • 今天正常上班,開了例會走诞,匯報內(nèi)容還是那兩件事副女,沒有太大問題。只是南雞蛋在夸了他們幾個之后順帶說讓他們也能夠支持我的...
    聶一一閱讀 97評論 0 0