вольный перевод статьи с дигитал оушен, доки и других ресурсов
Пакет состоит из файлов Go, которые находятся в одном каталоге и имеют в начале один и тот же оператор package.
Написание пакета аналогично написанию любого другого файла Go. Пакеты могут содержать определения функций, типов и переменных, которые затем можно использовать в других программах Go.
Каждый пакет должен иметь package comment - блок комментов, в котором рассказывается о пакете. Для многофайловых пакетов комментарий пакета должен присутствовать только в одном любом файле. Комментарий к пакету должен описать пакет и предоставлять относящуюся к нему информацию в целом. Например: