About code under the examples folder and lib module

[Tong Sun]

Hi,

when providing a lib/module, would sample code under the `examples` folder be considered/linked as part of the module? I guess Go linker would be smart enough to not include them, as they all have their own `func main()` in them, but just want to clarify / confirm. 

I remember seeing one lib/module, which, in order not to let the examples affect the module package size, even put the `examples` folder under `internal/`.

All in all, what's the idiomatic way for Go modules to provide usage examples, everything under the same `examples` folder, or different packages having their own `examples` folders, or other ways? thx.

[Brian Candler]

It's only going to compile/link packages which are referenced by an "import" statement (recursively).