Sourcegraph: "A single example is worth 1000 lines of documentation"

Re:Sourcegraph: "A single example is worth 1000 lines of doc... by gman129 on Wednesday May 28, 2014 @02:59PM (#7812107)

Examples usually show you how do things like a parrot, but you don't get the idea of why these things happen as they do without some documentation.

[ Parent | on HN ]

Re:Sourcegraph: "A single example is worth 1000 lines of doc... by daphneokeefe on Wednesday May 28, 2014 @03:47PM (#7812387)

I agree. I think the difference is the sequence you do it in. For me, it is so much easier to get the code and look at it and step through it, THEN read the documentation. This approach helps me to focus on the parts that are unfamiliar, which I will research in more depth. At some point, you do need to read the documentation. Just not necessarily monolithically before you start experimenting with the code.

[ Parent | on HN ]