一个 SAP 开发工程师十余年的技术写作之路回顾
這是 Jerry 2021 年的第 31 篇文章,也是汪子熙公眾號(hào)總共第 307 篇原創(chuàng)文章。
本文目錄
- 汪子熙公眾號(hào)的風(fēng)格定位
- 為什么我會(huì)開始在微信公眾號(hào)上書寫技術(shù)文章
- 我的寫作素材從哪里來
- 堅(jiān)持了長達(dá)十余年的技術(shù)寫作,我最大的三個(gè)收獲
Jerry 從 2018 年正式開始在微信公眾號(hào)平臺(tái)寫作,至今已經(jīng)整整三年半了。到 2021 年 4 月 30 日為止,總共輸出了 306 篇原創(chuàng)文章,獲得了 10000 個(gè)粉絲。
雖然我深知,這一萬個(gè)粉絲朋友,在整個(gè)數(shù)以億計(jì)的微信用戶群里,只是極其小眾的一個(gè)群體,不過我開啟公眾號(hào)技術(shù)文章寫作的初衷,絕非是“在 XXX 時(shí)間段內(nèi),粉絲數(shù)達(dá)到 XXX 個(gè)”。因此,對(duì)于公眾號(hào)的粉絲數(shù),以及每篇文章的閱讀量,點(diǎn)贊個(gè)數(shù),我也采取很佛系的態(tài)度去對(duì)待,一切順其自然。
當(dāng)今這個(gè)自媒體時(shí)代,每天都有新的微信公眾號(hào)涌現(xiàn)。然而能夠被大家記住,經(jīng)常保持關(guān)注和閱讀的,只有一小部分。這一小部分公眾號(hào)無疑都有各自鮮明的特色。
申請(qǐng)這個(gè)公眾號(hào)之初,我就對(duì)其有著清晰的定位,并且堅(jiān)持到了現(xiàn)在,那就是:嚴(yán)謹(jǐn),專業(yè)。
為了做到嚴(yán)謹(jǐn),這 306 篇原創(chuàng)文章,篇篇書寫的過程我都是字斟句酌,在發(fā)布之前自己也會(huì)重復(fù)讀幾遍,確認(rèn)思路是否清晰,行文邏輯有無問題,文章里描述的 SAP 知識(shí)點(diǎn),力爭(zhēng)做到 100% 正確。除此之外,我也會(huì)檢查語句是否通順,是否存在錯(cuò)別字。
為了做到內(nèi)容的專業(yè),我有三不寫。
- 和 SAP 不相關(guān)的技術(shù)不寫。
- 自己理解得似是而非,不夠深入的 SAP 技術(shù)不寫。
- 雞湯文不寫。
因?yàn)槌掷m(xù)發(fā)表技術(shù)文章,我也被邀請(qǐng)加入了一些微信公號(hào)主群。認(rèn)識(shí)了一些同仁,他/她們會(huì)琢磨和分析比較受歡迎的的文章類型,寫作方式和標(biāo)題命名方式等特征,然后模仿進(jìn)行創(chuàng)作,也能獲得不錯(cuò)的吸粉效果。然而采取這種方式打造出的文章,已經(jīng)和我對(duì)本公眾號(hào)的定位產(chǎn)生了較大的偏差,因此我沒有選擇去模仿,今后還是會(huì)一如既往堅(jiān)持自己的寫作風(fēng)格。
幾乎每天都有人在公眾號(hào)后臺(tái)聯(lián)系我,詢問我是否有興趣進(jìn)行商務(wù)合作,即在這個(gè)公眾號(hào)上發(fā)一些課程的推廣文章。然而我覺得這些課程(比如人工智能學(xué)習(xí)課程)的受眾,和本公眾號(hào)的粉絲相差很大,因此也沒有接受此類合作的請(qǐng)求。
為什么我會(huì)開始在微信公眾號(hào)上書寫技術(shù)文章
這要從我 2009 年還在做 SAP Business ByDesign 標(biāo)準(zhǔn)開發(fā)說起。當(dāng)時(shí)我負(fù)責(zé)這個(gè)產(chǎn)品的 Form 和 Field Extensibility 話題,從 2007 入職開始 已經(jīng)做了兩年多了,也習(xí)慣把自己對(duì)二者的一些理解和技術(shù)分析,寫到公司內(nèi)網(wǎng) wiki 上。另外我平時(shí)喜歡用 ABAP 寫一些小工具,能讓自己平時(shí)工作中少做些體力活。比如手動(dòng)在 SAP GUI 里點(diǎn)擊完成一個(gè)流程,需要十幾步的操作,但是寫一個(gè) ABAP 報(bào)表,然后 F8 執(zhí)行,一步即可完成。我把這些小工具的名稱,所在系統(tǒng)和使用方法也寫到了公司內(nèi)網(wǎng) wiki 上。堅(jiān)持一段時(shí)間后,我會(huì)不時(shí)收到一些其他同事的郵件,有的是感謝我寫的 wiki 幫助他/她們澄清了工作中的一些疑問,同時(shí)就 wiki 內(nèi)容提出了新的咨詢;有的則是覺得我寫的小工具很實(shí)用,但是和他/她們的使用場(chǎng)景還有差距,詢問我能不能再增強(qiáng)一下給他/她們團(tuán)隊(duì)使用。
下圖是我在公司內(nèi)網(wǎng) wiki 寫作的一個(gè)例子,寫于 2010 年 11 月。
在公司內(nèi)網(wǎng) wiki 寫作的習(xí)慣,我一直保留到了 2013 年,此時(shí)我已經(jīng)從 SAP Business ByDesign 開發(fā)團(tuán)隊(duì)轉(zhuǎn)到了 SAP CRM 團(tuán)隊(duì)。在一次員工和上級(jí)的例行談話時(shí),我不經(jīng)意向我的老板,就是后來 SAP 成都研究院的吳院長(詳見?我與SAP成都研究院吳院長的二三事?),提到我寫的 wiki, 在公司內(nèi)部還是有挺多同事在看的。吳院長就說, “這很好啊。你可以試著在 SAP 社區(qū)上寫,這樣能讓更多的人看見。” 我心想這提議不錯(cuò), 加上我也挺樂意在工作中嘗試新的方式方法,于是就開啟了我在 SAP 社區(qū)上的寫作之路。
從 2013 年到 2018 年,我總共在 SAP 社區(qū)上寫了 631 篇英文博客,其中 SAP UI5 & Fiori 221 篇,SAP CRM 198 篇,ABAP 197 篇。
常年在 SAP 社區(qū)寫作,我也獲得了一千個(gè)社區(qū)粉絲的關(guān)注,其中大部分是老外。
因?yàn)槲覍懙倪@些社區(qū)博客,以及我在社區(qū)上回答 SAP 從業(yè)者的問題,我也成為了 SAP 社區(qū)導(dǎo)師和 SAP 社區(qū)的技術(shù)大使。
2017 年獲得的 SAP Mentors Program Excellence & Dedication 的 一個(gè) Award:
SAP Technology Ambassadors 的衣服:
到了 2017 年底,因?yàn)槲易约撼掷m(xù)關(guān)注了一些微信技術(shù)公眾號(hào),從中獲益匪淺,所以萌生了自己也申請(qǐng)一個(gè)號(hào)并且使用中文進(jìn)行技術(shù)輸出的念頭。于是就有了現(xiàn)在這個(gè)公眾號(hào)。
我的寫作素材從哪里來
這個(gè)公眾號(hào)的絕大多數(shù)文章都取材于我的每日工作。當(dāng)我在 SAP 標(biāo)準(zhǔn)產(chǎn)品開發(fā)團(tuán)隊(duì)從事產(chǎn)品交付工作時(shí),這個(gè)崗位對(duì)開發(fā)人員的技術(shù)要求是精而深,所以我有足夠的時(shí)間和精力,進(jìn)行技術(shù)積累。同時(shí)感謝 SAP 對(duì)員工以人為本的培養(yǎng)方式,使得我有機(jī)會(huì)先后在不同的 SAP 產(chǎn)品團(tuán)隊(duì)工作,能接觸到不同類型,不同技術(shù)架構(gòu),不同編程語言實(shí)現(xiàn)的 SAP 標(biāo)準(zhǔn)產(chǎn)品。隨便舉一些例子:
我最近在 SAP Commerce Cloud 開發(fā)團(tuán)隊(duì)從事 Angular 前端開發(fā)時(shí)寫的一些文章:
-
SAP Commerce Cloud ( 電商云 ) 路由路徑的自定義配置與開發(fā)
-
一小時(shí)內(nèi)在本地搭建SAP Commerce Cloud(電商云)的前后臺(tái)運(yùn)行環(huán)境
-
SAP 產(chǎn)品一脈相承的 UI 增強(qiáng)思路,在 SAP Commerce Cloud(電商云) UI 增強(qiáng)實(shí)現(xiàn)中的體現(xiàn)
我在 SAP Cloud for Customer 產(chǎn)品開發(fā)團(tuán)隊(duì)工作時(shí),團(tuán)隊(duì)同事們和我寫的文章:
-
SAP Cloud for Customer Extensibility的設(shè)計(jì)與實(shí)現(xiàn)
-
SAP成都研究院大衛(wèi)哥:SAP C4C中國本地化之微信小程序集成
-
SAP成都研究院飛機(jī)哥: SAP C4C中國本地化之微信聊天機(jī)器人的集成
-
SAP成都研究院廖婧:SAP C4C社交媒體集成概述
-
淺談SAP C4S自動(dòng)化
-
SAP成都C4C小李探花:淺談Fiori Design Guidelines
SAP 成都研究院 S4CRM 開發(fā)團(tuán)隊(duì)的同事們和我寫的文章:
-
Hello World, S/4HANA for Customer Management 1.0
-
S/4HANA Service Management和SAP Field Service Management的集成
-
SAP S4CRM 1811 服務(wù)訂單API介紹
-
SAP S4CRM vs C4C, 諸葛亮和周瑜?
分享我在 SAP CRM Fiori 開發(fā)團(tuán)隊(duì)時(shí)所學(xué)知識(shí)的文章:
-
SAP Fiori應(yīng)用的三種部署方式
-
雪妖現(xiàn)世:給SAP Fiori Launchpad增添雪花紛飛的效果
-
SAP Fiori Launchpad Tile,UI5應(yīng)用,和PFCG Role的對(duì)應(yīng)關(guān)系
2018 年到 2020 年 4 月底這三年,我在 SAP 成都研究院數(shù)字創(chuàng)新空間團(tuán)隊(duì)工作,基于 SAP C/4HANA 產(chǎn)品線做一些概念驗(yàn)證和原型開發(fā)。如果說 SAP 標(biāo)準(zhǔn)產(chǎn)品交付團(tuán)隊(duì)對(duì)開發(fā)人員的要求是精而深,那么做原型開發(fā),概念驗(yàn)證,配合售前同事打單,從事這些工作的開發(fā)人員,就得做到廣而博,即在最短的時(shí)間內(nèi),用當(dāng)下業(yè)界流行的技術(shù),完成能夠進(jìn)行演示的原型。
這三年里,我的團(tuán)隊(duì)同事們和我也將完成的很多原型開發(fā),以文章和視頻的方式分享了出來,比如:
-
Hyperledger Fabric on SAP Cloud Platform
-
SAP云平臺(tái),區(qū)塊鏈,超級(jí)賬本和智能合約
-
打通C/4HANA和S/4HANA的一個(gè)原型開發(fā):智能服務(wù)創(chuàng)新案例
-
SAP成都研究院數(shù)字創(chuàng)新空間溝通S/4HANA和C/4HANA的智能服務(wù)演示視頻和Coresystems分享預(yù)告
-
在SAP UI中使用純JavaScript顯示產(chǎn)品主數(shù)據(jù)的3D模型視圖
-
如何在SAP UI5應(yīng)用里添加使用攝像頭拍照的功能
以及 SAP 成都研究院的同事們和我的職場(chǎng)之路分享:
-
SAP成都研究院Sunshine: 我的C4C實(shí)習(xí)感受和保研之路
-
SAP成都研究院35歲以上的開發(fā)人員都去哪兒了?
-
“最不合格”的SAP應(yīng)聘者: 從大學(xué)生到SAP成都研究院開發(fā)工程師
-
SAP成都研究院馬洪波:提升學(xué)習(xí)力,增強(qiáng)競(jìng)爭(zhēng)力,收獲一生樂趣
-
從程序猿到SAP產(chǎn)品經(jīng)理,我是如何轉(zhuǎn)型的?(上篇)
-
從程序猿到SAP產(chǎn)品經(jīng)理,我是如何轉(zhuǎn)型的?(下篇)
-
我與SAP成都研究院吳院長的二三事
-
我是怎么和SAP結(jié)緣的 - Jerry的SAP校園招聘之路
-
那些年伴我一起成長的SAP裝備
由于篇幅限制,本文羅列出來的只是冰山一角。全部的 306 篇原創(chuàng)文章,可以從下面的鏈接獲得:
-
SAP成都研究院小伙伴們2018~2019兩年間的179篇原創(chuàng)文章合集
-
一個(gè)SAP成都研究院開發(fā)工程師 2020 年的所有文章列表
當(dāng)然我也試圖在技術(shù)文章中添加一些趣味性,讓它們顯得不那么枯燥:
-
一段讓人瑟瑟發(fā)抖的ABAP代碼
-
昨日萬圣節(jié)ABAP怪獸級(jí)代碼謎團(tuán),公布答案啦
-
ABAP vs Java, 蛙泳 vs 自由泳
-
淺談前后端分離思想對(duì)自由泳練習(xí)的指導(dǎo)意義
-
我用ABAP做過的那些無聊的事情
-
金庸的武俠世界和SAP的江湖
-
使用代碼列出金庸小說中使用過的所有成語
-
關(guān)于SAP ABAP字符變量和字符串變量字符個(gè)數(shù)的一個(gè)知識(shí)點(diǎn),和一個(gè)血案
堅(jiān)持了長達(dá)十年的技術(shù)寫作,我最大的三個(gè)收獲
收獲頗多,這里只說三點(diǎn)。
1. 梳理和完善了自己的知識(shí)體系。
技術(shù)人員有時(shí)候會(huì)遇到一種情況,認(rèn)為自己掌握了一個(gè)知識(shí)點(diǎn),但當(dāng)試圖將其用語言或者文字講解給別人聽時(shí),發(fā)現(xiàn)事實(shí)并不像自己想象得那樣。自己認(rèn)為已經(jīng)透徹理解的知識(shí)點(diǎn),其實(shí)卻領(lǐng)悟得似是而非。
我在技術(shù)寫作時(shí)也偶爾會(huì)遇到這種情形,然后只能中斷寫作過程,重新查閱 SAP 幫助文檔,閱讀源代碼,單步調(diào)試,思考,直至我有足夠的自信,已經(jīng) 100% 理解了該知識(shí)點(diǎn),然后才敢繼續(xù)往下寫。
在經(jīng)歷過多個(gè) SAP 產(chǎn)品的標(biāo)準(zhǔn)開發(fā)工作后,通過寫作,我能夠有意識(shí)地去分析這些不同產(chǎn)品的一些共性,比如 SAP 產(chǎn)品在發(fā)版之前都必須確保滿足的可擴(kuò)展性 (Extensibility) 這一非功能性需求,于是有了這篇文章:
SAP產(chǎn)品增強(qiáng)技術(shù)回顧
很多 SAP 產(chǎn)品都允許 Key User 進(jìn)行字段增強(qiáng),比如 SAP CRM,SAP Cloud for Customer 和 SAP S/4HANA. 這些不同產(chǎn)品的字段增強(qiáng)方式的 UI 雖然有差異,但設(shè)計(jì)思路卻有相通之處:
-
SAP產(chǎn)品的Field Extensibility
-
SAP Cloud for Customer Extensibility的設(shè)計(jì)與實(shí)現(xiàn)
-
SAP 產(chǎn)品一脈相承的 UI 增強(qiáng)思路,在 SAP Commerce Cloud(電商云) UI 增強(qiáng)實(shí)現(xiàn)中的體現(xiàn)
SAP 不同類型的 CRM 解決方案的橫向比較:
-
SAP的這三款CRM解決方案,您能區(qū)分清楚么
-
SAP S4CRM vs C4C, 諸葛亮和周瑜?
一些 SAP 不同產(chǎn)品中某一特性的橫向比較:
-
SAP 幾款產(chǎn)品的 UI 設(shè)計(jì) 和 Salesforce UI 開發(fā)比較:SAP UI和Salesforce UI開發(fā)漫談
-
SAP 不同產(chǎn)品的 UI 搜索分頁的不同技術(shù)實(shí)現(xiàn):SAP UI 搜索分頁技術(shù)
-
SAP 不同產(chǎn)品里 OData 的不同技術(shù)實(shí)現(xiàn):SAP OData編程指南
-
SAP 不同產(chǎn)品里 API 開發(fā)的不同技術(shù)實(shí)現(xiàn):SAP API開發(fā)方法大全
以上都是知識(shí)體系梳理的例子。知識(shí)體系的完善,我的理解是:將看似割裂獨(dú)立的一個(gè)個(gè)知識(shí)點(diǎn),串成一個(gè)網(wǎng)狀或者樹狀結(jié)構(gòu)。
知識(shí)體系形成和完善后,再進(jìn)入新領(lǐng)域?qū)W習(xí)時(shí),就能靈活運(yùn)用自己已有的知識(shí)和經(jīng)驗(yàn),做到舉一反三了。
知乎上安曉輝老師有一篇文章:那些很厲害的人是怎么構(gòu)建知識(shí)體系的,值得一讀。
安曉輝老師對(duì)于知識(shí)體系的觀點(diǎn)我非常認(rèn)同:
知識(shí)體系是結(jié)構(gòu)化的,知識(shí)點(diǎn)之間彼此關(guān)聯(lián),有無數(shù)回路,四通八達(dá)。這樣的好處是,我們遇到一個(gè)問題,就會(huì)觸發(fā)某個(gè)知識(shí)點(diǎn),我們捕捉到這個(gè)知識(shí)點(diǎn),就可以沿著知識(shí)體系的無數(shù)關(guān)聯(lián)和回路,快速找到相關(guān)的其他知識(shí)的點(diǎn),組合起來,形成針對(duì)所遇到問題的解決方案,就表現(xiàn)出專業(yè)水準(zhǔn),就當(dāng)?shù)闷稹邦I(lǐng)域?qū)<摇敝Q。
2. 擴(kuò)大了自己的交際圈,認(rèn)識(shí)了很多朋友。
三年半的寫作,讓我結(jié)識(shí)了很多 SAP 中國研究院其他部門的同事,以及 SAP 生態(tài)圈的客戶和合作伙伴們。不少也是圈內(nèi)深受從業(yè)人員尊敬和認(rèn)可的成名人士,三人行必有我?guī)熝?#xff0c;我從這些朋友身上也學(xué)到了很多。
我自己還創(chuàng)建了一個(gè)技術(shù)交流群,里面匯聚了來自五湖四海國內(nèi)外的 SAP 從業(yè)者們,群內(nèi)的技術(shù)交流氛圍濃厚,里面討論的話題也給我提供了源源不斷的寫作素材。
3. 在持續(xù)寫作過程中,找到了自己的短板和不足
每逢寫作過程中卡殼的時(shí)候,我就意識(shí)到,自己對(duì)該領(lǐng)域的理解還存在問題。技術(shù)寫作讓我能發(fā)現(xiàn)自己的技術(shù)短板,從而明確將來努力的方向。
在寫作過程中,要回復(fù)讀者在文章內(nèi)的留言,和粉絲互動(dòng),不可避免就需要和人進(jìn)行互動(dòng)。有一種說法認(rèn)為,好的程序員邏輯思維能力強(qiáng),沉浸于代碼的海洋中游刃有余,但是往往不擅長和人打交道。而我通過技術(shù)寫作建立起來了一個(gè)人脈圈,我需要和圈內(nèi)不同背景的朋友打交道:SAP 同事,客戶,合作伙伴的開發(fā)顧問,合作伙伴的管理人員,SAP 自由職業(yè)者,學(xué)生等等。我很珍惜這種能夠與 SAP 生態(tài)圈內(nèi)各種類型的從業(yè)者交流的機(jī)會(huì),以此彌補(bǔ)我和人交流溝通方面的不足。
以上就是本公眾號(hào)關(guān)注者達(dá)到一萬之際,我對(duì)過去十余年來技術(shù)寫作之路的一個(gè)復(fù)盤。我也希望自己的身體狀況,能支持我將技術(shù)輸出繼續(xù)進(jìn)行下去。
感謝大家一路的支持和陪伴。
更多Jerry的原創(chuàng)文章,盡在:“汪子熙”:
總結(jié)
以上是生活随笔為你收集整理的一个 SAP 开发工程师十余年的技术写作之路回顾的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 英雄联盟2021佐伊怎么打野 LOL暮光
- 下一篇: 微信朋友圈自动点赞