some docs updates

sync/sync_head.go

@@ -11,8 +11,10 @@ import (
 // Head returns the Network Head.
 //
 // Known subjective head is considered network head if it is recent enough(now-timestamp<=blocktime)
-// Otherwise, head is requested from a trusted peer and
+// Otherwise, we attempt to request recent network head from a trusted peer and
 // set as the new subjective head, assuming that trusted peer is always fully synced.
+//
+// The request is limited with 2 seconds and otherwise potentially unrecent header is returned.
 func (s *Syncer[H]) Head(ctx context.Context, _ ...header.HeadOption[H]) (H, error) {
 	sbjHead, err := s.subjectiveHead(ctx)
 	if err != nil {
@@ -39,7 +41,7 @@ func (s *Syncer[H]) Head(ctx context.Context, _ ...header.HeadOption[H]) (H, err
 	}
 	defer s.getter.Unlock()
 	// limit time to get a recent header
-	// if can't get it - give what we have
+	// if we can't get it - give what we have
 	reqCtx, cancel := context.WithTimeout(ctx, time.Second*2) // TODO(@vgonkivs): make timeout configurable
 	defer cancel()
 	netHead, err := s.getter.Head(reqCtx, header.WithTrustedHead[H](sbjHead))