3 ms·

Thank you. This industry has a huge failure mode in touting tech used in projects/frameworks without linking out to at least the source so that someone can lear

Thank you. This industry has a huge failure mode in touting tech used in projects/frameworks without linking out to at least the source so that someone can learn about them. Can't tell you how many things I've bailed on because it was a pile of obscure library references that weren't (to me) worth looking up.

couchand 7y ago
To be fair, in this case the linked page is a subdirectory of the main Puppeteer project.
- kaycebasques 7y ago
  This is also an experimental project. Who here thoroughly documents their experiments? Although to be fair we did announce it at I/O so that calls for more documentation. Disclosure: Chrome DevTools docs guy
SideburnsOfDoom 7y ago
Indeed, there is a skill when doing technical writing of putting yourself in the position of a reader, particularly one who is competent but who doesn't already know the thing that you are trying to explain, or the context. It's not as common as it should be.