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
87
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
200
What were they thinking?
keithpitty
0
200
How not to have future developers curse you
keithpitty
1
70
Why I use Guard
keithpitty
0
140
Morphing your Ruby into Civil Tech
keithpitty
0
89
Loving Legacy Code
keithpitty
0
630
Better OO Design in Rails
keithpitty
0
76
Other Decks in Programming
See All in Programming
童醫院敏捷轉型的實踐經驗
cclai999
0
210
技術同人誌をMCP Serverにしてみた
74th
1
630
Goで作る、開発・CI環境
sin392
0
220
GitHub Copilot and GitHub Codespaces Hands-on
ymd65536
2
150
「テストは愚直&&網羅的に書くほどよい」という誤解 / Test Smarter, Not Harder
munetoshi
0
120
Quand Symfony, ApiPlatform, OpenAI et LangChain s'allient pour exploiter vos PDF : de la théorie à la production…
ahmedbhs123
0
150
なぜ「共通化」を考え、失敗を繰り返すのか
rinchoku
1
640
XP, Testing and ninja testing
m_seki
3
240
ソフトウェア品質を数字で捉える技術。事業成長を支えるシステム品質の マネジメント
takuya542
1
11k
Team topologies and the microservice architecture: a synergistic relationship
cer
PRO
0
1.2k
20250704_教育事業におけるアジャイルなデータ基盤構築
hanon52_
5
700
スタートアップの急成長を支えるプラットフォームエンジニアリングと組織戦略
sutochin26
1
4.3k
Featured
See All Featured
The Pragmatic Product Professional
lauravandoore
35
6.7k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
252
21k
Distributed Sagas: A Protocol for Coordinating Microservices
caitiem20
331
22k
Fantastic passwords and where to find them - at NoRuKo
philnash
51
3.3k
The Invisible Side of Design
smashingmag
301
51k
Documentation Writing (for coders)
carmenintech
72
4.9k
Unsuck your backbone
ammeep
671
58k
JavaScript: Past, Present, and Future - NDC Porto 2020
reverentgeek
48
5.4k
Stop Working from a Prison Cell
hatefulcrawdad
270
21k
Why You Should Never Use an ORM
jnunemaker
PRO
58
9.4k
Dealing with People You Can't Stand - Big Design 2015
cassininazir
367
26k
ReactJS: Keep Simple. Everything can be a component!
pedronauck
667
120k
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