Чтобы в двух разных комментах показать один и тот же кусок кода: в первом начать, прервать посреди комментария и во втором продолжить и закончить комментарий
Он все это позволяет, но имеет свои правила, сначала надо написать MyFunc потом описывать что делает. По этому godoc генерирует целую доку в виде html. Можно делать примеры, описания и куча всего минимум запариваясь
Можно решить таску написав три строки кода. Написать их в виме или в блокноте не самое главное. А главное дойди до решения, которое в разы дольше редактирования кода