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.9k
Token based API Security
sengopal
0
430
Resiliency using Hystrix
sengopal
0
79
BDD using Cucumber
sengopal
0
88
Introduction to Git and Github
sengopal
0
120
Introduction to Responsive Web Design
sengopal
0
59
Other Decks in Programming
See All in Programming
The Past, Present, and Future of Enterprise Java
ivargrimstad
0
420
ProxyによるWindow間RPC機構の構築
syumai
3
1.2k
ファインディ株式会社におけるMCP活用とサービス開発
starfish719
0
2k
The Past, Present, and Future of Enterprise Java with ASF in the Middle
ivargrimstad
0
170
AI Agents: How Do They Work and How to Build Them @ Shift 2025
slobodan
0
100
CJK and Unicode From a PHP Committer
youkidearitai
PRO
0
110
AIでLINEスタンプを作ってみた
eycjur
1
230
Zendeskのチケットを Amazon Bedrockで 解析した
ryokosuge
3
320
How Android Uses Data Structures Behind The Scenes
l2hyunwoo
0
480
MCPでVibe Working。そして、結局はContext Eng(略)/ Working with Vibe on MCP And Context Eng
rkaga
5
2.3k
スケールする組織の実現に向けた インナーソース育成術 - ISGT2025
teamlab
PRO
2
170
奥深くて厄介な「改行」と仲良くなる20分
oguemon
1
560
Featured
See All Featured
jQuery: Nuts, Bolts and Bling
dougneiner
64
7.9k
Exploring the Power of Turbo Streams & Action Cable | RailsConf2023
kevinliebholz
34
6k
Dealing with People You Can't Stand - Big Design 2015
cassininazir
367
27k
[Rails World 2023 - Day 1 Closing Keynote] - The Magic of Rails
eileencodes
36
2.5k
Become a Pro
speakerdeck
PRO
29
5.5k
Understanding Cognitive Biases in Performance Measurement
bluesmoon
29
1.9k
Rebuilding a faster, lazier Slack
samanthasiow
83
9.2k
RailsConf 2023
tenderlove
30
1.2k
Cheating the UX When There Is Nothing More to Optimize - PixelPioneers
stephaniewalter
285
14k
Being A Developer After 40
akosma
90
590k
Visualization
eitanlees
148
16k
Embracing the Ebb and Flow
colly
87
4.8k
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?