Jaki jest sens "przykładów" w ramach testowania go (golang)?

Question

Ostatnio czytałem w testing and examples w ramce testowania go i nie bardzo rozumiałem, do czego służą. Widzę, że dokumentacja mówi:

Pakiet również uruchamia i weryfikuje przykładowy kod. Przykładowe funkcje mogą zawierać komentarz wiersza konkluzji, który zaczyna się od "Output:" i jest porównywany ze standardowym wyjściem funkcji podczas wykonywania testów. (Porównanie ignoruje początkową i końcową spację).

Jednak nie doceniam powodu, dla którego to istnieje. Kiedy piszę moje testy, wydaje się, że powinno być więcej niż jasne, jak używać kodu, po prostu czytając testy jednostkowe i testy porównawcze. Jaką dodatkową motywację zapewnia sekcja przykładowa? Wydaje mi się to zbędne, ale jestem pewien, że twórcy go postawili to z dobrego powodu, szczególnie dlatego, że zdają się empatyzować dobrą praktykę programistyczną poprzez projektowanie swojego języka. Mam nadzieję, że zrozumiem ich motywację lub jak tę część języka można wykorzystać w pozytywny sposób w projekcie golang! :)

Answer 1

W Go, kod źródłowy służy również do generowania dokumentacji. Przykłady nie są przeznaczone do testowania, ale raczej do dokumentacji. Po skompilowaniu przykładów możesz upewnić się, że działają one prawidłowo dla każdego, kto ich używa.

Przykłady znalezione w standardowych bibliotekach można uruchamiać bezpośrednio w przeglądarce, korzystając z golang.org do przeglądania dokumentacji. Godoc.org zamiast tego łączy twój przykładowy kod bezpośrednio do play.golang.org, gdzie możesz go wypróbować.

przykładu i przykładu użycia, patrz http://golang.org/pkg/sort/