Что такое Example функция?

Example функция — специальная тестовая функция с префиксом Example. Служит двойной целью: автоматический тест + документация. Именование: ExampleFoo — пример для функции Foo, ExampleT_Method — для метода, Example — для пакета. Комментарий // Output: задаёт ожидаемый вывод, // Unordered output: — для недетерминированного порядка. go test запускает Example как обычный тест. godoc/pkg.go.dev показывает их в документации. Если нет // Output — функция компилируется, но не проверяется. Идеальный способ показать использование API.