You make some good points about the examples visibility in the docs. I suggest that you write up an issue on Go’s issue tracker.