github.com/AndrienkoAleksandr/go@v0.0.19/src/go/doc/testdata/examples/README.md (about)

     1  These files are processed by example_test.go:TestExamples.
     2  
     3  A .golden file is a txtar file with two sections for each example that should be
     4  created by doc.Examples from the corresponding .go file.
     5  
     6  One section, named EXAMPLE_NAME.Output, contains the example's output,
     7  the value of the field Example.Output.
     8  
     9  The other, named EXAMPLE_NAME.Play, contains the formatted code for a playable
    10  version of the example, the value of the field Example.Play.
    11  
    12  If a section is missing, it is treated as being empty.