While I agree with your point, the example you gave feels like a straw man. Or at least, a separation of "sharp edges" and "long documentation needed". Phrased

While I agree with your point, the example you gave feels like a straw man. Or at least, a separation of "sharp edges" and "long documentation needed". Phrased differently: Go: To make a something public, start the var name with uppercase. C++: To make things public, type the word 'public'. The Go pattern seems like more of a sharp edge than the C++ version, even though the C++ version might need more reading to learn.