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
93
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
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
690
Better OO Design in Rails
Avatar for Keith Pitty keithpitty
0
90

Other Decks in Programming

See All in Programming
「接続」—パフォーマンスチューニングの最後の一手 〜点と点を結ぶ、その一瞬のために〜
Avatar for 武田 憲太郎 kentaroutakeda
5
2.5k
PHP で mp3 プレイヤーを実装しよう
Avatar for memory m3m0r7
PRO
0
260
Kubernetes上でAgentを動かすための最新動向と押さえるべき概念まとめ
Avatar for Sota Makino sotamaki0421
3
480
年間50登壇、単著出版、雑誌寄稿、Podcast出演、YouTube、CM、カンファレンス主催……全部やってみたので面白さ等を比較してみよう / I’ve tried them all, so let’s compare how interesting they are.
Avatar for nrs nrslib
4
770
アーキテクチャモダナイゼーションとは何か
Avatar for nwiizo nwiizo
17
4.9k
ハンズオンで学ぶクラウドネイティブ
Avatar for Tatsuki Minami tatsukiminami
0
120
煩雑なSkills管理をSoC（関心の分離）により解決する――関心を分離し、プロンプトを部品として育てるためのOSSを作った話 / Solving Complex Skills Management Through SoC (Separation of Concerns)
Avatar for nrs nrslib
4
870
iOS機能開発のAI環境と起きた変化
Avatar for Ryu-nakayama ryunakayama
0
180
10年分の技術的負債、完済へ ― Claude Code主導のAI駆動開発でスポーツブルを丸ごとリプレイスした話
Avatar for nero15 takuya_houshima
0
2.4k
Going Multiplatform with Your Android App (Android Makers 2026)
Avatar for Márton Braun zsmb
2
390
L’IA au service des devs : Anatomie d'un assistant de Code Review
Avatar for Thomas Boileau toham
0
230
CursorとClaudeCodeとCodexとOpenCodeを実際に比較してみた
Avatar for Terisuke terisuke
1
420

Featured

See All Featured
Scaling GitHub
Avatar for Zach Holman holman
464
140k
Google's AI Overviews - The New Search
Avatar for Barry Adams badams
0
970
The Curse of the Amulet
Avatar for Matthew Lei leimatthew05
1
11k
Lessons Learnt from Crawling 1000+ Websites
Avatar for Charles Meaden charlesmeaden
PRO
1
1.2k
Navigating Weather and Climate Data
Avatar for Ryan Abernathey rabernat
0
160
[RailsConf 2023] Rails as a piece of cake
Avatar for Vladimir Dementyev palkan
59
6.5k
DevOps and Value Stream Thinking: Enabling flow, efficiency and business value
Avatar for Helen Beal helenjbeal
1
160
YesSQL, Process and Tooling at Scale
Avatar for Rocio Delgado rocio
174
15k
10 Git Anti Patterns You Should be Aware of
Avatar for Lemi Orhan Ergin lemiorhan
PRO
659
61k
Information Architects: The Missing Link in Design Systems
Avatar for Michelle Chin soysaucechin
0
880
What's in a price? How to price your products and services
Avatar for Michael Herold michaelherold
247
13k
Why Our Code Smells
Avatar for Brandon Keepers bkeepers
PRO
340
58k

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