碼代碼
三個(gè)月過去了燎字,在六月終于進(jìn)了團(tuán)隊(duì)腥椒。公司很土豪的花錢讓我們做了三個(gè)月無產(chǎn)出的小蛀蟲,三個(gè)月做的候衍,不是培訓(xùn)笼蛛,有點(diǎn)像入職是的設(shè)計(jì)及開發(fā)的考核,過不了的就直接拜拜蛉鹿,據(jù)說在日本被再見的人挺多的滨砍,而在總公司外的其他地方,像新加坡妖异,上海這些地方惋戏,比例肯定小于5%,區(qū)別僅僅在于早點(diǎn)通過他膳,和晚點(diǎn)通過响逢。這三個(gè)月做的開發(fā)和實(shí)際開發(fā)中用的技術(shù)棧沒半毛錢關(guān)系,除了趁這個(gè)機(jī)會(huì)好好熟悉了下 JavaScript 之外矩乐,對工作有用的點(diǎn)龄句,應(yīng)該就在于了解和熟悉公司的開發(fā)模式和理念側(cè)重回论,說白了就是讓程序員也有以用戶為中心的概念散罕,這點(diǎn)很重要,但用三個(gè)月的時(shí)間通過兩次的開發(fā)文檔來強(qiáng)調(diào)傀蓉,投入產(chǎn)出比會(huì)不會(huì)太高了點(diǎn)欧漱?是不是應(yīng)該在除了總公司外的地區(qū)適當(dāng)?shù)恼{(diào)整這個(gè)流程?
三個(gè)月過后葬燎,才正式進(jìn)入六月的主題误甚「克Γ“考核”過后,才是真正接觸公司在用的前后端框架窑邦。前兩周是在自學(xué)各種各樣的框架擅威,后兩周就進(jìn)具體的團(tuán)隊(duì),開始干活了冈钦。短短幾周郊丛,讀了大量的技術(shù)文檔,簡談點(diǎn)體會(huì)瞧筛。
技術(shù)文檔厉熟,條理要清晰,內(nèi)容要準(zhǔn)確较幌。讀的這些文檔揍瑟,有開發(fā)環(huán)境搭建說明,有分步教程乍炉,也有概念性的說明绢片。如果跟著文檔做下來,能夠順利完成想要做到的預(yù)期效果恩急,那是大快人心杉畜。如果過程中,碰到了點(diǎn)什么問題衷恭,對于一個(gè)小白來說此叠,在幾番嘗試后,還是解決不了随珠,是很讓人沮喪的灭袁,“我明明完完全全按照它說的做了,為什么還是不可以窗看?”茸歧,如果是寫代碼上還好,有足夠的耐心显沈,基本可以自己解決软瞎,最要命的是環(huán)境搭建文檔,一個(gè)小地方的疏忽拉讯,或者因?yàn)榘姹靖露臋n沒有及時(shí)更新涤浇,之前沒有經(jīng)驗(yàn)的人,可能花一整天都配置不好魔慷,找不到人幫忙的話只锭,分分鐘要罵街。文檔的重要用處之一就是 可以一次性把做法記錄清楚院尔,省去重復(fù)的人力蜻展。如果大部分人都需要去求助的話喉誊,那這個(gè)文檔就有點(diǎn)雞肋了,需要有人專門的去修改和更新纵顾,而最合適的人選伍茄,就是剛過解決問題的人,整理解決方案施逾,過程中順便把文檔一更新幻林,個(gè)人對解決方案加強(qiáng)了印象,也造福了后來人音念。
準(zhǔn)確性之外沪饺,文檔另外一點(diǎn)很重要的就是條理性,條理清晰的文檔闷愤,有助于提高閱讀者的閱讀效率整葡。條理不清的文檔,對于讀者來說讥脐,簡直是折磨遭居,估計(jì)就是一路懵逼的讀完了,恍然大悟旬渠,原來是這個(gè)邏輯俱萍,你就不能好好寫,寫清楚嗎告丢?
本質(zhì)上來說枪蘑,要寫好技術(shù)文檔,就多想想閱讀的人岖免,這么寫閱讀的人能看懂嗎岳颇?對方是否有足夠的技術(shù)背景?他們在過程中會(huì)遇到哪些問題颅湘?是不是太高估讀者了话侧,要再多加點(diǎn)細(xì)節(jié)?是不是把讀者當(dāng)白癡了闯参,要省去一些繁雜的東西瞻鹏?
簡單說,就是以用戶為中心鹿寨。
碼字
六月就寫了三篇文章:
從100到10000的方法論 ——《從優(yōu)秀到卓越》 :讀書筆記/讀后感新博,從100到10000,重在專注释移。
看 草間彌生 展覽前叭披,你要知道的:看了個(gè)展寥殖,了解點(diǎn)背景玩讳。
如何使用 Git Hook 自動(dòng)部署服務(wù)器涩蜘?:搭了博客和個(gè)人網(wǎng)站,順便一總結(jié)熏纯。
1分鐘你也可以寫一首曲 :某天的 Google Doodle同诫,很棒的“作曲”小游戲。
查看歷史文章樟澜,可以上我的博客去看看:http://blog.zhuangweiming.me/
陸續(xù)會(huì)把文章都更新到上面误窖。
總結(jié)
某處看到的一句話:越萬里之溟濛兮,見鳳之流光秩贰。