Every package should have a package comment introducing the package. It provides information relevant to the package as a whole and generally sets expectations for the package. Especially in large packages, it can be helpful for the package comment to give a brief overview of the most important parts of the API, linking to other doc comments as needed.
Каждый пакет должен иметь комментарий, представляющий пакет. Он предоставляет информацию, относящуюся к пакету в целом, и в целом определяет ожидания от пакета. Комментарий к пакету может быть полезен, особенно в больших пакетах, чтобы дать краткий обзор наиболее важных частей API, при необходимости ссылаясь на другие комментарии к документации.