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
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
240
What were they thinking?
keithpitty
0
250
How not to have future developers curse you
keithpitty
1
86
Why I use Guard
keithpitty
0
160
Morphing your Ruby into Civil Tech
keithpitty
0
110
Loving Legacy Code
keithpitty
0
700
Better OO Design in Rails
keithpitty
0
95
Other Decks in Programming
See All in Programming
まずはプロンプトガイドを読もう、話はそれからだ
kiakiraki
1
190
わからない話を追いかけたら、プログラミング言語を作る側にいた
ydah
3
530
2年かけて Deno に DOMMatrix を実装した話 / How I implemented DOMMatrix in Deno over two years
petamoriken
0
220
言葉の格闘技のススメ~紙とペンと言葉から始める、キャリアの描き方~
progresscicada
2
170
プロポーザルを書いてもらう
pvcresin
0
570
夏だ!祭りだ!祭りとはドメインモデリングでは?
ryugen04
0
350
まだ間に合う!今年の夏こそSchemeのマクロ展開器を完全理解!
omasanori
0
300
運用ダッシュボードの設計を誰も教えてくれないのだけどみなさんどうしてるんですか? - チームに監視するという文化を根付かせるための第一歩を踏みたい -
satoshi256kbyte
1
140
引き算の組織 ― アウトカムとAIに全振りするために辞めたこと ― / Organization by Subtraction
hirokiyamamoto14
PRO
0
270
生成AI導入の「期待外れ」を乗り越える ー 開発フロー改革が目指す、真の組織変革
starfish719
0
5k
VibeCodingからAgenticWorkflowへ
starfish719
0
740
PostgreSQL 18で考えるUUID主キー
kazuhiro1982
0
500
Featured
See All Featured
Chasing Engaging Ingredients in Design
codingconduct
0
280
Highjacked: Video Game Concept Design
rkendrick25
PRO
1
440
Save Time (by Creating Custom Rails Generators)
garrettdimon
PRO
32
4.4k
The Art of Programming - Codeland 2020
erikaheidi
57
14k
4 Signs Your Business is Dying
shpigford
187
23k
brightonSEO & MeasureFest 2025 - Christian Goodrich - Winning strategies for Black Friday CRO & PPC
cargoodrich
3
780
It's Worth the Effort
3n
188
29k
Agile that works and the tools we love
rasmusluckow
331
22k
Building Better People: How to give real-time feedback that sticks.
wjessup
370
20k
How To Stay Up To Date on Web Technology
chriscoyier
790
250k
No one is an island. Learnings from fostering a developers community.
thoeni
21
3.8k
Designing Dashboards & Data Visualisations in Web Apps
destraynor
232
55k
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