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
0
93

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
Tweet

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
82
Why I use Guard
Avatar for Keith Pitty keithpitty
0
150
Morphing your Ruby into Civil Tech
Avatar for Keith Pitty keithpitty
0
110
Loving Legacy Code
Avatar for Keith Pitty keithpitty
0
680
Better OO Design in Rails
Avatar for Keith Pitty keithpitty
0
90

Other Decks in Programming

See All in Programming
存在論的プログラミング： 時間と存在を記述する
Avatar for Akihito Koriyama koriym
5
580
どんと来い、データベース信頼性エンジニアリング / Introduction to DBRE
Avatar for nnaka2992 nnaka2992
1
350
20260320登壇資料
Avatar for 松井遼(まついはるか) pharct
0
140
Symfony + NelmioApiDocBundle を使った スキーマ駆動開発 / Schema Driven Development with NelmioApiDocBundle
Avatar for Shohei Okada okashoi
0
250
生成 AI 時代のスナップショットテストってやつを見せてあげますよ（α版）
Avatar for ojun ojun9
0
320
Coding at the Speed of Thought: The New Era of Symfony Docker
Avatar for Kévin Dunglas dunglas
0
3.3k
Coding as Prompting Since 2025
Avatar for Jimmy Moon ragingwind
0
370
20260313 - Grafana & Friends Taipei #1 - Kubernetes v1.36 的開發雜記：那些困在 Alpha 加護病房太久的 Metrics
Avatar for ChengHao Yang tico88612
0
240
AI Assistants for Your Angular Solutions @Angular Graz, March 2026
Avatar for Manfred Steyer manfredsteyer
PRO
0
130
我々はなぜ「層」を分けるのか〜「関心の分離」と「抽象化」で手に入れる変更に強いシンプルな設計〜 #phperkaigi / PHPerKaigi 2026
Avatar for shogogg shogogg
2
710
Ruby and LLM Ecosystem 2nd
Avatar for Koichi ITO koic
1
1.4k
モダンOBSプラグイン開発
Avatar for Kaito Udagawa umireon
0
190

Featured

See All Featured
We Have a Design System, Now What?
Avatar for Morgane Peng morganepeng
55
8k
Design of three-dimensional binary manipulators for pick-and-place task avoiding obstacles (IECON2024)
Avatar for konakalab konakalab
0
390
A Tale of Four Properties
Avatar for Chris Coyier chriscoyier
163
24k
[Rails World 2023 - Day 1 Closing Keynote] - The Magic of Rails
Avatar for Eileen M. Uchitelle eileencodes
38
2.8k
Java REST API Framework Comparison - PWX 2021
Avatar for Matt Raible mraible
34
9.2k
ラッコキーワード サービス紹介資料
Avatar for ラッコ株式会社 rakko
1
2.8M
ReactJS: Keep Simple. Everything can be a component!
Avatar for Pedro Nauck pedronauck
666
130k
4 Signs Your Business is Dying
Avatar for Josh Pigford shpigford
187
22k
Winning Ecommerce Organic Search in an AI Era - #searchnstuff2025
Avatar for Aleyda Solis aleyda
1
1.9k
Lessons Learnt from Crawling 1000+ Websites
Avatar for Charles Meaden charlesmeaden
PRO
1
1.2k
Principles of Awesome APIs and How to Build Them.
Avatar for Keavy McMinn keavy
128
17k
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
Avatar for Eileen M. Uchitelle eileencodes
141
35k

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