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

How not to give advice (about Markdown)

Keith Pitty
September 12, 2017

How not to give advice (about Markdown)

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

Keith Pitty

September 12, 2017
Tweet

More Decks by Keith Pitty

Other Decks in Programming

Transcript

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

    View Slide

  2. How
    not
    to give advice?

    View Slide

  3. A story …

    View Slide

  4. One day
    I was asked …

    View Slide

  5. for advice

    View Slide

  6. A colleague was
    struggling …

    View Slide

  7. Eleanor

    View Slide

  8. Indonesian
    launch

    View Slide

  9. i18n yml

    View Slide

  10. id.yml

    View Slide

  11. View Slide

  12. Markdown

    View Slide

  13. nested lists?

    View Slide

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

    View Slide

  15. View Slide

  16. Markdown

    View Slide

  17. How could
    I help?

    View Slide

  18. subset of HTML

    View Slide

  19. type attribute

    View Slide


  20. outer 1

    inner 1
    inner 2


    outer 2

    View Slide

  21. not supported
    by markdown

    View Slide

  22. View Slide

  23. I was focussed

    View Slide

  24. on Markdown

    View Slide

  25. View Slide

  26. my advice?

    View Slide

  27. Markdown

    View Slide

  28. HTML

    View Slide

  29. type attribute

    View Slide

  30. View Slide


  31. View Slide

  32. View Slide


  33. View Slide

  34. View Slide

  35. Done!

    View Slide

  36. View Slide

  37. merged PR

    View Slide

  38. View Slide

  39. but then …

    View Slide

  40. Mark

    View Slide

  41. CSS

    View Slide

  42. list-style

    View Slide

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

    View Slide

  44. CSS
    +
    Markdown

    View Slide

  45. View Slide

  46. View Slide

  47. View Slide

  48. I apologised

    View Slide

  49. profusely!

    View Slide

  50. time to reflect

    View Slide

  51. Where had I
    gone wrong?

    View Slide

  52. View Slide

  53. tunnel vision?

    View Slide

  54. lateral thinking?

    View Slide

  55. comfort zone?

    View Slide

  56. tools?

    View Slide

  57. Teamwork?

    View Slide

  58. View Slide

  59. learning
    opportunity

    View Slide

  60. next time …

    View Slide

  61. meanwhile …

    View Slide

  62. Teamwork!

    View Slide

  63. @conversationEDU

    View Slide

  64. @keithpitty

    View Slide