Naming, layout and comments: descriptive full-word names, one item per line in wrapped calls and literals, and doc comments on exported names

Short and single-letter names in application code become full words (tests
keep theirs). Wrapped calls, signatures and composite literals put one item
per line, and one-line function bodies are expanded. Exported names and
groups of constants get doc comments, and comments refer to the renamed
identifiers.

internal/findatender/findatender.go

@@ -35,17 +35,17 @@ func WithLogger(logger *slog.Logger) Option {
 // 60 seconds and are retried once. Call Shutdown when finished with it. It
 // logs to slog.Default() unless given WithLogger.
 func New(conf *config.JobSearchConfig, apiRoot string, opts ...Option) *FindATender {
-	ft := &FindATender{
+	findATender := &FindATender{
 		config:  conf,
 		apiRoot: apiRoot,
 	}
 	for _, opt := range opts {
-		opt(ft)
+		opt(findATender)
 	}
-	ft.httpClient = resty.New().
+	findATender.httpClient = resty.New().
 		SetTimeout(60 * time.Duration(time.Second)).
 		SetRetryCount(1)
-	return ft
+	return findATender
 }
 
 // logger returns the logger the client logs to, tagged with its component.