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 not to give advice (about Markdown)
Search
Keith Pitty
September 12, 2017
Programming
0
91
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
Tweet
Share
More Decks by Keith Pitty
See All by Keith Pitty
Succeeding with Remote Retrospectives
keithpitty
0
220
What were they thinking?
keithpitty
0
220
How not to have future developers curse you
keithpitty
1
78
Why I use Guard
keithpitty
0
150
Morphing your Ruby into Civil Tech
keithpitty
0
110
Loving Legacy Code
keithpitty
0
670
Better OO Design in Rails
keithpitty
0
88
Other Decks in Programming
See All in Programming
CSC307 Lecture 10
javiergs
PRO
1
660
CSC307 Lecture 02
javiergs
PRO
1
780
16年目のピクシブ百科事典を支える最新の技術基盤 / The Modern Tech Stack Powering Pixiv Encyclopedia in its 16th Year
ahuglajbclajep
5
1k
Data-Centric Kaggle
isax1015
2
780
今こそ知るべき耐量子計算機暗号(PQC)入門 / PQC: What You Need to Know Now
mackey0225
3
380
ノイジーネイバー問題を解決する 公平なキューイング
occhi
0
110
Oxlintはいいぞ
yug1224
5
1.3k
高速開発のためのコード整理術
sutetotanuki
1
410
LLM Observabilityによる 対話型音声AIアプリケーションの安定運用
gekko0114
2
430
React 19でつくる「気持ちいいUI」- 楽観的UIのすすめ
himorishige
11
7.4k
CSC307 Lecture 06
javiergs
PRO
0
690
CSC307 Lecture 04
javiergs
PRO
0
660
Featured
See All Featured
So, you think you're a good person
axbom
PRO
2
1.9k
Automating Front-end Workflow
addyosmani
1371
200k
Visualizing Your Data: Incorporating Mongo into Loggly Infrastructure
mongodb
49
9.9k
Lessons Learnt from Crawling 1000+ Websites
charlesmeaden
PRO
1
1.1k
Typedesign – Prime Four
hannesfritz
42
2.9k
The Web Performance Landscape in 2024 [PerfNow 2024]
tammyeverts
12
1k
<Decoding/> the Language of Devs - We Love SEO 2024
nikkihalliwell
1
130
The Director’s Chair: Orchestrating AI for Truly Effective Learning
tmiket
1
97
Future Trends and Review - Lecture 12 - Web Technologies (1019888BNR)
signer
PRO
0
3.2k
Building a A Zero-Code AI SEO Workflow
portentint
PRO
0
320
技術選定の審美眼(2025年版) / Understanding the Spiral of Technologies 2025 edition
twada
PRO
117
110k
Leveraging LLMs for student feedback in introductory data science courses - posit::conf(2025)
minecr
0
150
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