Answer stability and product-owner: New's godoc says where the load lands, plainer Performance wording, regenerate before re-pinning, and no redundant sort

2026-10-03 17:52:29 +02:00
parent cc8797744b
commit 590681ed24
4 changed files with 9 additions and 10 deletions
@@ -86,7 +86,8 @@ func WithoutShippedData() Option {
 // in order with the last winning a name clash. Each JSON file becomes a category
 // named after the file (address.json -> "address") and each subdirectory a
 // namespace segment. It errors on a missing directory, invalid JSON, invalid data,
-// or no data at all.
+// or no data at all. The shipped set alone loads each category on the first call
+// reaching it; beside WithDataPath or WithDataFS, every category loads here.
 func New(opts ...Option) (*Generator, error) {
 	c := config{shipped: true}
 	for _, opt := range opts {