Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
How developers write documentation
Search
Senthilkumar Gopal
March 18, 2020
Programming
0
30
How developers write documentation
How developers write documentation
Senthilkumar Gopal
March 18, 2020
Tweet
Share
More Decks by Senthilkumar Gopal
See All by Senthilkumar Gopal
Scaling ML embedding models to serve a billion queries
sengopal
0
390
Paper Review of ConvNext
sengopal
0
180
Portfolio for CS 6475 Computational Photography
sengopal
0
40
Our Agile Pursuit of Happyness
sengopal
0
1.8k
Token based API Security
sengopal
0
430
Resiliency using Hystrix
sengopal
0
79
BDD using Cucumber
sengopal
0
87
Introduction to Git and Github
sengopal
0
120
Introduction to Responsive Web Design
sengopal
0
58
Other Decks in Programming
See All in Programming
私の後悔をAWS DMSで解決した話
hiramax
4
180
AI時代のドメイン駆動設計-DDD実践におけるAI活用のあり方 / ddd-in-ai-era
minodriven
25
9.6k
サーバーサイドのビルド時間87倍高速化
plaidtech
PRO
0
690
【第4回】関東Kaggler会「Kaggleは執筆に役立つ」
mipypf
0
1k
Honoアップデート 2025年夏
yusukebe
1
900
2025 年のコーディングエージェントの現在地とエンジニアの仕事の変化について
azukiazusa1
10
4.8k
オープンセミナー2025@広島「君はどこで動かすか?」アンケート結果
satoshi256kbyte
0
230
レガシープロジェクトで最大限AIの恩恵を受けられるようClaude Codeを利用する
tk1351
4
1.5k
Microsoft Orleans, Daprのアクターモデルを使い効率的に開発、デプロイを行うためのSekibanの試行錯誤 / Sekiban: Exploring Efficient Development and Deployment with Microsoft Orleans and Dapr Actor Models
tomohisa
0
230
OSS開発者という働き方
andpad
5
1.6k
AI時代のUIはどこへ行く?
yusukebe
9
4.8k
ECS初心者の仲間 – TUIツール「e1s」の紹介
keidarcy
0
150
Featured
See All Featured
Why You Should Never Use an ORM
jnunemaker
PRO
59
9.5k
Designing Dashboards & Data Visualisations in Web Apps
destraynor
231
53k
Easily Structure & Communicate Ideas using Wireframe
afnizarnur
194
16k
XXLCSS - How to scale CSS and keep your sanity
sugarenia
248
1.3M
Fantastic passwords and where to find them - at NoRuKo
philnash
52
3.4k
Building a Scalable Design System with Sketch
lauravandoore
462
33k
Reflections from 52 weeks, 52 projects
jeffersonlam
351
21k
GraphQLとの向き合い方2022年版
quramy
49
14k
Sharpening the Axe: The Primacy of Toolmaking
bcantrill
44
2.5k
Chrome DevTools: State of the Union 2024 - Debugging React & Beyond
addyosmani
7
830
Imperfection Machines: The Place of Print at Facebook
scottboms
268
13k
Being A Developer After 40
akosma
90
590k
Transcript
How developers code write @sengopal
What is Documentation
What is Documentation Material that provides official information or evidence
or that serves as a record. Written specification and instructions accompanying a computer program.
Aspects READABILITY Available Offline No custom tools Standard Templates EDITOR
Available Offline No custom tools Basic In built generators for TOC, tables etc., Reviews DISTRIBUTION Versioned Zero staleness Close to source of truth
Available Today https://xkcd.com/927/
Google Docs Microsoft Word Wiki O365 What’s the point of
this presentation anyway?
GITHUB Available Offline No custom tools Versioned and Reviews Close
to source of truth Zero staleness Templates - define your own! this ←
Lingua Franca MARKDOWN Released in 2004 Lightweight markup Plain text
formatting Converted to HTML Readme files Online forums ASCIIDOC Released in 2002 Equivalent to DocBook Plain-text mark-up DocBook tool-chain PDF, TeX, manpages, e- books, slides, Git
None
None
Choice http://counterinception.com/sites/default/files/pictures/MatrixBluePillRedPill.jpg
Asciidoc Why book writers are switching to Asciidoc 1. Better
UI control 2. Admonitions 3. Macros such as TOC 4. Env. Variables 5. Advanced Table support 6. Page Navigation 7. More…. Asciidoc Reference
My Toolset
Toolset Github Asciidoc AsciidocFx Atom/Chrome Plugin
Side Note Github Wiki Gollum Static Site Generators staticgen
Questions?