Официальный гайд по GoDoc-комментам

Мало кто знает, но такой гайд существует. Если хочешь стать godoc-мастером, очень рекомендую. Коллеги будут очень благодарны.

Здесь подробно разобрано:

- что такое godoc
- в каких случаях стоит писать такие комменты (спойлер - every exported name should have a doc comment)
- как их правильно писать в разных случаях (для типов, функций, констант, переменных и т.п.)
- как всё это форматировать

Всё разобрано очень подробно, приводится множество примеров.

#article #godoc #codestyle