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

Single Page Docs

Brandon Philips
April 09, 2013
100

Single Page Docs

Brandon Philips

April 09, 2013
Tweet

Transcript

  1. Single Page Docs
    @BrandonPhilips
    [email protected]
    Monday, April 8, 13

    View full-size slide

  2. Monday, April 8, 13

    View full-size slide

  3. Doc Anti-Patterns
    Monday, April 8, 13

    View full-size slide

  4. Monday, April 8, 13

    View full-size slide

  5. Monday, April 8, 13

    View full-size slide

  6. Single Page Patterns
    Monday, April 8, 13

    View full-size slide

  7. Monday, April 8, 13

    View full-size slide

  8. • Single Page
    Monday, April 8, 13

    View full-size slide

  9. • Single Page
    • Persistent Navigation
    Monday, April 8, 13

    View full-size slide

  10. • Single Page
    • Persistent Navigation
    • Dynamic Orientation
    Monday, April 8, 13

    View full-size slide

  11. Single Page
    Monday, April 8, 13

    View full-size slide

  12. Monday, April 8, 13

    View full-size slide

  13. Monday, April 8, 13

    View full-size slide

  14. • Scrolling is natural
    Monday, April 8, 13

    View full-size slide

  15. • Scrolling is natural
    • Search is free in browsers
    Monday, April 8, 13

    View full-size slide

  16. Monday, April 8, 13

    View full-size slide

  17. • Forces beginning, middle and end thinking
    Monday, April 8, 13

    View full-size slide

  18. • Forces beginning, middle and end thinking
    • Fewer and simpler editor windows
    Monday, April 8, 13

    View full-size slide

  19. Persistent Navigation
    Monday, April 8, 13

    View full-size slide

  20. Monday, April 8, 13

    View full-size slide

  21. Monday, April 8, 13

    View full-size slide

  22. • Reduces frustration of skipping ahead
    Monday, April 8, 13

    View full-size slide

  23. • Reduces frustration of skipping ahead
    • Feels natural to quickly find TOC
    Monday, April 8, 13

    View full-size slide

  24. Monday, April 8, 13

    View full-size slide

  25. • Constantly reminded of section bloat
    Monday, April 8, 13

    View full-size slide

  26. • Constantly reminded of section bloat
    • Reduce length of section names
    Monday, April 8, 13

    View full-size slide

  27. Dynamic Orientation
    Monday, April 8, 13

    View full-size slide

  28. Monday, April 8, 13

    View full-size slide

  29. Monday, April 8, 13

    View full-size slide

  30. • How much more?
    Monday, April 8, 13

    View full-size slide

  31. • How much more?
    • What did I read?
    Monday, April 8, 13

    View full-size slide

  32. • How much more?
    • What did I read?
    • Should I skip ahead?
    Monday, April 8, 13

    View full-size slide

  33. Terminology
    Monday, April 8, 13

    View full-size slide

  34. Fixie Docs
    Monday, April 8, 13

    View full-size slide

  35. Building a Fixie
    Monday, April 8, 13

    View full-size slide

  36. Know the Downsides
    Monday, April 8, 13

    View full-size slide

  37. The Right Match
    Monday, April 8, 13

    View full-size slide

  38. Monday, April 8, 13

    View full-size slide

  39. Splitting the Docs
    Monday, April 8, 13

    View full-size slide

  40. Monday, April 8, 13

    View full-size slide

  41. Tools
    Monday, April 8, 13

    View full-size slide

  42. What about size?
    Monday, April 8, 13

    View full-size slide

  43. 0
    750
    1500
    2250
    3000
    Uncompressed Compressed
    Full Express API Neil deGrasse Tyson
    Monday, April 8, 13

    View full-size slide

  44. A Product*
    Monday, April 8, 13

    View full-size slide

  45. Monday, April 8, 13

    View full-size slide

  46. github.com/philips/fixiedocs
    Monday, April 8, 13

    View full-size slide

  47. Thanks!
    @BrandonPhilips
    http://ifup.org
    Monday, April 8, 13

    View full-size slide