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
24
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
210
Paper Review of ConvNext
sengopal
0
110
Portfolio for CS 6475 Computational Photography
sengopal
0
15
Our Agile Pursuit of Happyness
sengopal
0
1.7k
Token based API Security
sengopal
0
340
Resiliency using Hystrix
sengopal
0
40
BDD using Cucumber
sengopal
0
49
Introduction to Git and Github
sengopal
0
68
Introduction to Responsive Web Design
sengopal
0
48
Other Decks in Programming
See All in Programming
DMMプラットフォームがTiDB Cloudを採用した背景
pospome
8
3.9k
try! Swift Tokyo 初参加報告LT
hinakko2
0
210
Rethinking UI building strategies @ SFI 2024
letelete
0
270
MicrosoftのPlatform Engineeringガイドを読んで実際になにかやってみた
ymd65536
1
180
Semantic search with Django and pgvector
pauloxnet
0
240
スクラムチームと認知負荷 - ニフティのスクラムトーク Vol2. / NIFTY Tech Talk #18
niftycorp
PRO
1
120
AWS Application Composerで始める、 サーバーレスなデータ基盤構築 / 20240406-jawsug-hokuriku-shinkansen
kasacchiful
1
260
[技育CAMPアカデミア]アイディアを形に!【超入門】スマホアプリ開発〜リリースまでの流れをご紹介
teamlab
PRO
0
350
1BRC--Nerd Sniping the Java Community
gunnarmorling
0
330
Ruby GitHub Packages
bkuhlmann
0
630
Folding Cheat Sheet #2
philipschwarz
PRO
0
120
Javaエンジニアのための Nodejs/Nuxt3入門
hidekatsu_izuno
0
290
Featured
See All Featured
RailsConf 2023
tenderlove
2
530
Designing for Performance
lara
601
67k
Debugging Ruby Performance
tmm1
70
11k
The Straight Up "How To Draw Better" Workshop
denniskardys
227
130k
A better future with KSS
kneath
231
16k
The Brand Is Dead. Long Live the Brand.
mthomps
48
28k
Building Better People: How to give real-time feedback that sticks.
wjessup
354
18k
Web development in the modern age
philhawksworth
202
10k
YesSQL, Process and Tooling at Scale
rocio
163
13k
Visualization
eitanlees
135
14k
Bash Introduction
62gerente
604
210k
How to Create Impact in a Changing Tech Landscape [PerfNow 2023]
tammyeverts
12
1.5k
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?