Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Sign up for free
Menu
Search
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Pricing
Search
Sign in
Sign up for free
How not to give advice (about Markdown)
Search
Sponsored
·
Ship Features Fearlessly
Turn features on and off without deploys. Used by thousands of Ruby developers.
→
Keith Pitty
September 12, 2017
Programming
110
0
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
How not to give advice (about Markdown)
A short talk given at the Sydney Ruby or Rails Meetup on 12 September, 2017
Keith Pitty
September 12, 2017
More Decks by Keith Pitty
See All by Keith Pitty
Succeeding with Remote Retrospectives
keithpitty
0
250
What were they thinking?
keithpitty
0
260
How not to have future developers curse you
keithpitty
1
88
Why I use Guard
keithpitty
0
160
Morphing your Ruby into Civil Tech
keithpitty
0
110
Loving Legacy Code
keithpitty
0
710
Better OO Design in Rails
keithpitty
0
97
Other Decks in Programming
See All in Programming
AWSに止められる覚悟してますか?
morizo_1984
2
490
GitHubハンズオン講座 — 実務レベルのチーム開発のフローを身につけよう
junhat6
0
110
KiroのSpecで「五目並べ」を作ってみる
satoshi256kbyte
1
320
Agents on Rails - Rails at Scale 2026
irinanazarova
0
300
Omarchy Tokyo やると聞いて UMPC 買ってセットアップしてきた
mtsmfm
0
200
仕様駆動開発による爆速プロダクト開発 / Bakusoku Spec Driven Development
kobakei
0
150
UnityでSystem.Net.WebSocketsなWebSocketサーバが動かないのでUnity Monoのコードを覗いてみた / about implementing websocket server with unity mono
drumath2237
1
510
Unity6 URPによる海底をテーマにしたVJシステムの解説 | Unity Shader 完全に理解した 勉強会
gam0022
0
170
Are APIs Still Relevant in the AI Era?
soyuka
0
380
Augmenting AI with the Power of Jakarta EE
ivargrimstad
0
370
App Intentsのビルドプロセスを支える技術
kntkymt
0
480
パズルゲームの作り方 / how to make puzzle games
kaityo256
PRO
2
250
Featured
See All Featured
Winning Ecommerce Organic Search in an AI Era - #searchnstuff2025
aleyda
2
2.2k
Color Theory Basics | Prateek | Gurzu
gurzu
1
480
4 Signs Your Business is Dying
shpigford
187
23k
Large-scale JavaScript Application Architecture
addyosmani
515
110k
Neural Spatial Audio Processing for Sound Field Analysis and Control
skoyamalab
0
530
Testing 201, or: Great Expectations
jmmastey
46
8.3k
Evolution of real-time – Irina Nazarova, EuRuKo, 2024
irinanazarova
9
1.6k
The Spectacular Lies of Maps
axbom
PRO
1
1.1k
Accessibility Awareness
sabderemane
1
230
jQuery: Nuts, Bolts and Bling
dougneiner
66
8.6k
Design and Strategy: How to Deal with People Who Don’t "Get" Design
morganepeng
133
20k
Fashionably flexible responsive web design (full day workshop)
malarkey
409
67k
Transcript
How not to give advice (about Markdown) Keith Pitty @keithpitty
@ConversationEDU
How not to give advice?
A story …
One day I was asked …
for advice
A colleague was struggling …
Eleanor
Indonesian launch
i18n yml
id.yml
None
Markdown
nested lists?
a. outer 1 i. inner 1 ii. inner 2 b.
outer 2
None
Markdown
How could I help?
subset of HTML
type attribute
<ol type=“a”> <li>outer 1 <ol type =“i”> <li>inner 1 <li>inner
2 </ol> </li> <li>outer 2</li> </ol>
not supported by markdown
None
I was focussed
on Markdown
None
my advice?
Markdown
HTML
type attribute
None
…
None
…
None
Done!
None
merged PR
None
but then …
Mark
CSS
list-style
ul { list-style: lower-alpha; li:before { display: none; } ul
{ list-style: lower-roman; } }
CSS + Markdown
None
None
None
I apologised
profusely!
time to reflect
Where had I gone wrong?
None
tunnel vision?
lateral thinking?
comfort zone?
tools?
Teamwork?
None
learning opportunity
next time …
meanwhile …
Teamwork!
@conversationEDU
@keithpitty