Upgrade to Pro — share decks privately, control downloads, hide ads and more …

How not to give advice (about Markdown)

Avatar for Keith Pitty Keith Pitty
September 12, 2017
Programming
97
0

How not to give advice (about Markdown)

A short talk given at the Sydney Ruby or Rails Meetup on 12 September, 2017

Avatar for Keith Pitty

Keith Pitty

September 12, 2017

More Decks by Keith Pitty

See All by Keith Pitty
Succeeding with Remote Retrospectives
Avatar for Keith Pitty keithpitty
0
230
What were they thinking?
Avatar for Keith Pitty keithpitty
0
230
How not to have future developers curse you
Avatar for Keith Pitty keithpitty
1
85
Why I use Guard
Avatar for Keith Pitty keithpitty
0
160
Morphing your Ruby into Civil Tech
Avatar for Keith Pitty keithpitty
0
110
Loving Legacy Code
Avatar for Keith Pitty keithpitty
0
690
Better OO Design in Rails
Avatar for Keith Pitty keithpitty
0
90

Other Decks in Programming

See All in Programming
ソフトウェア設計の結合バランス #phperkaigi
Avatar for Takuma Kajikawa kajitack
0
480
How We Benchmarked Quarkus: Patterns and anti-patterns
Avatar for Holly Cummins hollycummins
1
180
Structured Concurrency, Scoped Values and Joiners in the JDK 25 26 27
Avatar for José josepaumard
1
140
Explore CoroutineScope
Avatar for tomoEng11 tomoeng11
0
150
의존성 주입과 모듈화
Avatar for Sungyong An fornewid
0
160
エラー処理の温故知新 / history of error handling technic
Avatar for nakaryo ryotanakaya
7
1.8k
いつか誰かが、と思っていた フロントエンド刷新5年間の実践知
Avatar for Kiichi Sugihara kiichisugihara
1
250
Agent Skills を社内で育てる仕組み作り
Avatar for jackchuka jackchuka
0
260
ハーネスエンジニアリングにどう向き合うか 〜ルールファイルを超えて開発プロセスを設計する〜 / How to approach harness engineering
Avatar for r-kagaya rkaga
26
18k
Spec-Driven Development with AI Agents (Workshop, May 2026)
Avatar for Anton Arhipov antonarhipov
2
280
JAWS-UG横浜 #100 祝・第100回スペシャル AWS は VPC レスの時代へ
Avatar for maroon1st maroon1st
0
210
HTML-Aware ERB: The Path to Reactive Rendering @ RubyKaigi 2026, Hakodate, Japan
Avatar for Marco Roth marcoroth
0
620

Featured

See All Featured
Connecting the Dots Between Site Speed, User Experience & Your Business [WebExpo 2025]
Avatar for Tammy Everts tammyeverts
11
900
Reflections from 52 weeks, 52 projects
Avatar for Jefferson Lam jeffersonlam
356
21k
The World Runs on Bad Software
Avatar for Brandon Keepers bkeepers
PRO
72
12k
Lightning Talk: Beautiful Slides for Beginners
Avatar for Ines Montani inesmontani
PRO
1
530
Visual Storytelling: How to be a Superhuman Communicator
Avatar for David Neal reverentgeek
2
530
Six Lessons from altMBA
Avatar for Skipper Chong Warson skipperchong
29
4.2k
Paper Plane
Avatar for Katie Cordina Lindsey katiecoart
PRO
1
49k
Designing for Performance
Avatar for Lara Hogan lara
611
70k
DevOps and Value Stream Thinking: Enabling flow, efficiency and business value
Avatar for Helen Beal helenjbeal
1
180
The Curse of the Amulet
Avatar for Matthew Lei leimatthew05
1
12k
The browser strikes back
Avatar for Jono Alderson jonoalderson
0
1k
Efficient Content Optimization with Google Search Console & Apps Script
Avatar for Katarina Dahlin katarinadahlin
PRO
1
530

Transcript

  1. How not to give advice (about Markdown) Keith Pitty @keithpitty

    @ConversationEDU

  2. How not to give advice?

  3. A story …

  4. One day I was asked …

  5. for advice

  6. A colleague was struggling …

  7. Eleanor

  8. Indonesian launch

  9. i18n yml

  10. id.yml

  11. None

  12. Markdown

  13. nested lists?

  14. a. outer 1 i. inner 1 ii. inner 2 b.

    outer 2
  15. None

  16. Markdown

  17. How could I help?

  18. subset of HTML

  19. type attribute

  20. <ol type=“a”> <li>outer 1 <ol type =“i”> <li>inner 1 <li>inner

    2 </ol> </li> <li>outer 2</li> </ol>

  21. not supported by markdown

  22. None

  23. I was focussed

  24. on Markdown

  25. None

  26. my advice?

  27. Markdown

  28. HTML

  29. type attribute

  30. None

  31. …

  32. None

  33. …

  34. None

  35. Done!

  36. None

  37. merged PR

  38. None

  39. but then …

  40. Mark

  41. CSS

  42. list-style

  43. ul { list-style: lower-alpha; li:before { display: none; } ul

    { list-style: lower-roman; } }

  44. CSS + Markdown

  45. None
  46. None
  47. None

  48. I apologised

  49. profusely!

  50. time to reflect

  51. Where had I gone wrong?

  52. None

  53. tunnel vision?

  54. lateral thinking?

  55. comfort zone?

  56. tools?

  57. Teamwork?

  58. None

  59. learning opportunity

  60. next time …

  61. meanwhile …

  62. Teamwork!

  63. @conversationEDU

  64. @keithpitty