成為技術作家:路徑3工程師參加他們的第一個社區教程

成為技術作家:路徑3工程師參加他們的第一個社區教程

DigitalOcean社區教程的常規讀者(比如如何使用Ubuntu 18.04上的Let加密來保護Apache或如何使用DigitalOcean Droplets啟動Hadoop集群)可能已經註意到除了設置說明之外,教程通常包含從中獲得的見解,提示和痛點。現實世界的生產場景。這是因為其中許多是由DevOps工程師,系統管理員和軟件開發人員編寫的,他們渴望在工作中推出軟件和系統時分享解決方案和變通方法。

通過教程,DigitalOcean作者將他們的戰鬥經驗貢獻給更廣泛的開發者社區,並在此過程中鞏固他們對技術概念的理解。一些作者全職在DigitalOcean社區寫作團隊工作,而其他人則作為Write for DOnations計劃的一部分提供教程,該計劃將作者的支出與對以技術為重點的非營利組織的慈善捐贈相匹配。所有社區貢獻者都有一種共同的精神,即通過教學“回饋”讀者,無論這些讀者是經驗豐富的工程經理,還是第一次在建立Nginx服務器或Jupyter筆記本電腦的學生。

DigitalOcean教程可以大致分為概念或程序。例如,Kubernetes簡介本質上更具概念性,因為作者向讀者提供了一個軟件或DevOps概念的概述,並將其歸結為一組易於理解的核心思想。另一方面,如何在Kubernetes上設置Elasticsearch,Fluentd和Kibana(EFK)日誌堆棧是支持開發人員設置其基礎結構的程序性演練。本教程逐步為讀者介紹一種或多種技術的安裝和配置,通常會提供有價值的見解和背景信息。

成為技術作家

成為DigitalOcean教程編寫者沒有“一條路”。 Mitchell Anicas,前社區團隊的高級技術作家,現在是Billing團隊的高級軟件工程師,他的職業生涯始於夏威夷大學的系統管理員。搬遷到紐約後,他利用多年管理系統和自動化配置和部署的經驗,開始全職編寫Linux和基礎架構教程。

“在作為系統管理員工作時,我引用的許多教程都不完整,或者實際上並不是那麼高質量。很多人寫博客文章說“這就是這對我有用的東西”,“他說。 “自從我站在另一邊,我對讀者有了很多的同情。”雖然他以前從未在其他社區作家的幫助下編寫過教程(所有教程都經過同行編輯和其他人的技術測試他是社區團隊的成員,他開始在Ubuntu 14.04上發佈如何安裝Elasticsearch,Logstash和Kibana(ELK Stack)以及為Web應用程序設置5個通用服務器設置等文章。

另一方面,阿姆斯特丹以外的軟件工程師兼作家Erika Heidi一直是作家。 “我一直很喜歡寫作,因為我很年輕,”她說。 “我發現我可以將博客作為一個平台,用於記錄設置服務器和解決常見Linux問題等技術問題,既可以作為我自己的未來參考,也可以作為分享我學習內容的一種方式。”

作為社區作者,她提供了許多教程,包括如何在Ubuntu 16.04上使用Let’s Encrypt保護Apache,以及從作為DevOps工程師的豐富經驗中獲得的概念性文章,如什麼是高可用性和配置管理簡介。像米切爾一樣,她的技術經驗賦予她對同齡人所面臨的問題以及她可以提供的填補空白的解決方案的敏銳認識。

傑里米·莫里斯也採取了類似的方式發布他的第一個DigitalOcean教程:“作為一名計算機科學專業的學生,我偶爾會寫博客文章,了解我在實習期間學到的一些東西,以此來深入了解這些主題並且與他人分享我的知識,“他回憶道。他的一位教授Lisa Tagliaferri現在管理著DigitalOcean的內部社區作家團隊,他建議他利用他新獲得的Python和Django經驗,編寫一個關於構建博客的系列教程。這最終導致他發布了Django教程,如如何在Ubuntu 16.04上安裝Django和設置開發環境,如何創建Django應用程序並將其連接到數據庫以及如何創建Django模型,所有他熟悉的主題他的專業工作。

米切爾,埃里卡和傑里米都成為了他們在科技事業不同階段的作家。他們共同希望通過分享來自挑戰DevOps問題的來之不易的解決方案來幫助他們的同行,這使他們發布了他們的第一個DigitalOcean教程。在撰寫和教育他人的過程中,他們需要培養獨特的溝通技巧,他們發現以清晰易懂的方式描述解決方案的挑戰值得與他們的工程經驗一起發展。

為何寫?

技術寫作可以成為工程工作的有力補充,要求作者在比完成日常任務所需的更深層次上理解和處理概念。 Erika在深入了解她作為DevOps工程師所使用的技術的過程中發現,編寫教程可以幫助她真正熟悉新的想法:“工程中有很多東西我知道怎麼做因為我已經完成了以前多次,它只是工作,但如果我必須解釋它是如何工作的,我不能,“她說。 “寫作有助於我’解開’我的想法,因為我必須將這些想法解釋並組織成合乎邏輯的步驟。”

它也可以是一種非常有益的追求。通過發布開源技術教程,Erika認為她正在幫助其他同樣在她的學習道路上伸出援手的人:“我相信這種滿足來自於我分享可能對其他人有用的東西的感覺。我正在尋找教程以及如何在互聯網上做所有的事情,這是我可以回饋社區的一種方式。“

米切爾股份這個意義上說就能夠通過教程貢獻他的經驗和知識:“這很酷,能夠通過寫作來幫助成千上萬的人,尤其是對DigitalOcean,其教程在大的尊重和認可由開發者社區寫的教程。我將參加一個會議,遇到一個人,他們會說’哦,是的,我用你的教程設置一個ELK堆棧,非常感謝!’“

Leave a Comment

Your email address will not be published.