How not to give advice (about Markdown)

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

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