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
400
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
80
BDD using Cucumber
sengopal
0
90
Introduction to Git and Github
sengopal
0
120
Introduction to Responsive Web Design
sengopal
0
59
Other Decks in Programming
See All in Programming
ポスターセッション: 「まっすぐ行って、右!」って言ってラズパイカーを動かしたい 〜生成AI × Raspberry Pi Pico × Gradioの試作メモ〜
komofr
0
1.2k
『毎日の移動』を支えるGoバックエンド内製開発
yutautsugi
2
220
詳しくない分野でのVibe Codingで困ったことと学び/vibe-coding-in-unfamiliar-area
shibayu36
3
4.7k
The Flutter Journey of Building a Live Streaming App — With a Side of Performance Tuning
u503
1
100
非同期jobをtransaction内で 呼ぶなよ!絶対に呼ぶなよ!
alstrocrack
0
580
What's new in Spring Modulith?
olivergierke
1
120
CSC509 Lecture 06
javiergs
PRO
0
260
CSC509 Lecture 03
javiergs
PRO
0
330
XP, Testing and ninja testing ZOZ5
m_seki
3
520
CSC305 Lecture 06
javiergs
PRO
0
210
Your Perfect Project Setup for Angular @BASTA! 2025 in Mainz
manfredsteyer
PRO
0
150
Web Components で実現する Hotwire とフロントエンドフレームワークの橋渡し / Bridging with Web Components
da1chi
3
2k
Featured
See All Featured
A Tale of Four Properties
chriscoyier
160
23k
Helping Users Find Their Own Way: Creating Modern Search Experiences
danielanewman
30
2.9k
How to Think Like a Performance Engineer
csswizardry
27
2k
Building Flexible Design Systems
yeseniaperezcruz
329
39k
Bash Introduction
62gerente
615
210k
ピンチをチャンスに:未来をつくるプロダクトロードマップ #pmconf2020
aki_iinuma
127
53k
The Language of Interfaces
destraynor
162
25k
[RailsConf 2023] Rails as a piece of cake
palkan
57
5.9k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
252
21k
Facilitating Awesome Meetings
lara
56
6.6k
Scaling GitHub
holman
463
140k
Designing Dashboards & Data Visualisations in Web Apps
destraynor
231
53k
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?