Как писать примеры в тестах?

Example функции в Go — исполняемая документация. Пишешь в _test.go файле функцию ExampleMyFunc() с комментарием // Output: expected. go test проверяет, что вывод совпадает. Если не совпадает — тест падает. Это гарантирует, что примеры в документации всегда актуальны. Example функции отображаются на pkg.go.dev рядом с документацией. Формат: func ExampleReverse() { fmt.Println(Reverse("hello")) // Output: olleh }. Для методов: ExampleT_Method(). Для пакета: Example(). Очень удобно — и документация, и тест в одном.