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
90

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
210
What were they thinking?
Avatar for Keith Pitty keithpitty
0
220
How not to have future developers curse you
Avatar for Keith Pitty keithpitty
1
72
Why I use Guard
Avatar for Keith Pitty keithpitty
0
140
Morphing your Ruby into Civil Tech
Avatar for Keith Pitty keithpitty
0
90
Loving Legacy Code
Avatar for Keith Pitty keithpitty
0
660
Better OO Design in Rails
Avatar for Keith Pitty keithpitty
0
83

Other Decks in Programming

See All in Programming
モデル駆動設計をやってみよう Modeling Forum2025ワークショップ/Let’s Try Model-Driven Design
Avatar for haru860 haru860
0
170
詳細の決定を遅らせつつ実装を早くする
Avatar for shimabox shimabox
1
1.3k
Developing Specifications - Jakarta EE: a Real World Example
Avatar for ivargrimstad ivargrimstad
0
130
歴史から学ぶ「Why PHP？」 PHPを書く理由を改めて理解する / Learning from History: “Why PHP?” Rediscovering the Reasons for Writing PHP
Avatar for shiro seike seike460
PRO
0
160
Nitro v3
Avatar for kazupon kazupon
2
320
ゼロダウンタイムでミドルウェアの バージョンアップを実現した手法と課題
Avatar for つっつん wind111
0
210
Building AI with AI
Avatar for Ines Montani inesmontani
PRO
1
240
物流DXを支える“意味”の設計：セマンティックレイヤーとAIで挑むデータ基盤/登壇資料（飯塚 大地）
Avatar for Hacobu hacobu
PRO
0
100
OSS開発者の憂鬱
Avatar for Yusuke Wada yusukebe
12
5.3k
イベントストーミングのはじめかた / Getting Started with Event Storming
Avatar for nrs nrslib
1
650
カンファレンス遠征を（安く）楽しむ技術
Avatar for 藤掛大介 wp_daisuke
0
180
GraalVM Native Image トラブルシューティング機能の最新状況（2025年版）
Avatar for NTTドコモソリューションズ　Java担当 ntt_dsol_java
0
160

Featured

See All Featured
個人開発の失敗を避けるイケてる考え方 / tips for indie hackers
Avatar for panda_program panda_program
118
20k
Thoughts on Productivity
Avatar for Jon Yablonski jonyablonski
73
4.9k
CSS Pre-Processors: Stylus, Less & Sass
Avatar for Bermon Painter bermonpainter
359
30k
Documentation Writing (for coders)
Avatar for Carmen Chung carmenintech
76
5.1k
Why Our Code Smells
Avatar for Brandon Keepers bkeepers
PRO
340
57k
Principles of Awesome APIs and How to Build Them.
Avatar for Keavy McMinn keavy
127
17k
Designing for Performance
Avatar for Lara Hogan lara
610
69k
Performance Is Good for Brains [We Love Speed 2024]
Avatar for Tammy Everts tammyeverts
12
1.3k
Automating Front-end Workflow
Avatar for Addy Osmani addyosmani
1371
200k
Six Lessons from altMBA
Avatar for Skipper Chong Warson skipperchong
29
4.1k
How to Think Like a Performance Engineer
Avatar for Harry Roberts csswizardry
28
2.3k
Visualization
Avatar for Eitan Lees eitanlees
150
16k

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