Hasty Treat - Reading Documentation — Syntax Podcast 073

A Tasty Treats Podcast for Web Developers.

Ask a Potluck Question →
Wes Bos

Wes Bos

Full Stack JavaScript Developer. Creator of really good web development courses. BBQ enthusiast.

Scott Tolinski

Scott Tolinski

Web Developer, Creator of Level Up Tuts, Bboy, Robotops Crew and Youtuber

Playing: 073: Hasty Treat - Reading Documentation

0:00

LOUDNESS

Sep 10th, 2018

Hasty Treat - Reading Documentation

👇 Download Show✏️ Edit Show Notes

In this Hasty Treat, Scott and Wes dive into documentation - how to avoid common pitfalls and overwhelm, as well as how to read, understand and get the most out of documentation.

Sentry - Sponsor

If you want to know what's happening with your errors, track them with Sentry. Sentry is open-source error tracking that helps developers monitor and fix crashes in real time. Cut your time on error resolution from five hours to five minutes. It works with any language and integrates with dozens of other services. Syntax listeners can get two months for free by visiting Sentry.io and using the coupon code "tastytreat".

Show Notes

5:10 - What are the different kinds of documentation?

14:34 - How to read documentation

  • Understanding how you learn will save you lots of time

16:03 - Understanding Parameters

  • Parameter types
  • Required / Optional
  • Parameter order

22:45 - How do you tackle learning something new?

  • Look at some examples
  • Scan the entire docs to get an idea of the surface area
  • Have something specific in mind that you want to build

27:34 - What to do when the docs suck?

  • Look at other people's code
  • Chat rooms
  • Tests for examples
  • Read the source code
  • Github search
  • Contribute

Tweet us your tasty treats!