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
91

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
220
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
78
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
670
Better OO Design in Rails
Avatar for Keith Pitty keithpitty
0
88

Other Decks in Programming

See All in Programming
組織で育むオブザーバビリティ
Avatar for ryotaro kobayashi ryota_hnk
0
180
dchart: charts from deck markup
Avatar for Anthony Starks ajstarks
3
1k
AI & Enginnering
Avatar for codelynx codelynx
0
120
例外処理とどう使い分ける？Result型を使ったエラー設計 #burikaigi
Avatar for Takuma Kajikawa kajitack
16
6.1k
カスタマーサクセス業務を変革したヘルススコアの実現と学び
Avatar for Tomoyuki Hamaguchi _hummer0724
0
730
20260127_試行錯誤の結晶を1冊に。著者が解説 先輩データサイエンティストからの指南書 / author's_commentary_ds_instructions_guide
Avatar for nash_efp nash_efp
1
980
humanlayerのブログから学ぶ、良いCLAUDE.mdの書き方
Avatar for Yuto tsukamoto1783
0
200
AIと一緒にレガシーに向き合ってみた
Avatar for nyafunta9858 nyafunta9858
0
250
SourceGeneratorのススメ
Avatar for tkym htkym
0
200
要求定義・仕様記述・設計・検証の手引き - 理論から学ぶ明確で統一された成果物定義
Avatar for Kuniwak orgachem
PRO
1
170
[KNOTS 2026登壇資料]AIで拡張‧交差する プロダクト開発のプロセス および携わるメンバーの役割
Avatar for hisatake hisatake
0
290
Automatic Grammar Agreementと Markdown Extended Attributes
について
Avatar for Kishikawa Katsumi kishikawakatsumi
0
200

Featured

See All Featured
My Coaching Mixtape
Avatar for mlcsv mlcsv
0
48
Building a Scalable Design System with Sketch
Avatar for Laura Van Doore lauravandoore
463
34k
Principles of Awesome APIs and How to Build Them.
Avatar for Keavy McMinn keavy
128
17k
Design in an AI World
Avatar for tapps tapps
0
140
Are puppies a ranking factor?
Avatar for Jono Alderson jonoalderson
1
2.7k
Fight the Zombie Pattern Library - RWD Summit 2016
Avatar for Marcelo Somers marcelosomers
234
17k
Building Flexible Design Systems
Avatar for Yesenia Perez-Cruz yeseniaperezcruz
330
40k
Sharpening the Axe: The Primacy of Toolmaking
Avatar for Bryan Cantrill bcantrill
46
2.7k
Abbi's Birthday
Avatar for Violet Bock coloredviolet
1
4.8k
Done Done
Avatar for chrislema chrislema
186
16k
A Tale of Four Properties
Avatar for Chris Coyier chriscoyier
162
24k
Cheating the UX When There Is Nothing More to Optimize - PixelPioneers
Avatar for Stéphanie Walter stephaniewalter
287
14k

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