News for hackers. Stuff that matters.
Re:Facebook Go Libraries by autarch on Thursday November 13, 2014 @01:30PM (#8603119)
The crappy documentation is very much in line with many Go libraries, sadly. There doesn't seem to be a great culture of documentation. People often just write bare API docs without explaining why the library is useful or showing a lot of examples.
Re:Facebook Go Libraries by djhworld on Thursday November 13, 2014 @05:33PM (#8604598)
Never experienced this, godoc https://godoc.org/ is a good resource
Re:Facebook Go Libraries by autarch on Friday November 14, 2014 @01:44AM (#8606090)
I was complaining about exactly the docs I've found on godoc.org.
Re:Facebook Go Libraries by yvsong on Thursday November 13, 2014 @02:01PM (#8603356)
It may be a cultural difference of system programmers (including Go designers and developers) and (consumer) application programmers (e.g., as in the Apple camp). System programmers regard themselves higher, prefer terse symbol names, specs, docs, mathematical expressions, and formal methods, don't seem fans of Objective C or Java style readability and verbosity. But then again, it's open source software -- No one owes anyone anything.
Re:Facebook Go Libraries by Dewie on Thursday November 13, 2014 @03:17PM (#8603781)
> formal methods

Go and formal methods? Seriously? It's one of those things that I imagine the Go community rejecting as being academic and not about getting stuff done.

^ that's not a value judgement, btw. I have no experience with applying formal methods myself.