i dont like commits

internal/scraper/openapi.go

@@ -42,12 +42,12 @@ func (s *OpenAPIScraper) Scrape(ctx context.Context, source *Source) ([]*Documen
 
 	raw, specURL, err := s.readSpec(ctx, source)
 	if err != nil {
-		return nil, err
+		return nil, fmt.Errorf("read openapi spec: %w", err)
 	}
 
 	spec, err := parseOpenAPISpec(raw)
 	if err != nil {
-		return nil, err
+		return nil, fmt.Errorf("parse openapi spec %q: %w", specURL, err)
 	}
 
 	docs := make([]*Document, 0)
@@ -138,7 +138,7 @@ func (s *OpenAPIScraper) readSpec(ctx context.Context, source *Source) ([]byte,
 	if strings.HasPrefix(rawPath, "http://") || strings.HasPrefix(rawPath, "https://") {
 		req, err := http.NewRequestWithContext(ctx, http.MethodGet, rawPath, nil)
 		if err != nil {
-			return nil, "", err
+			return nil, "", fmt.Errorf("build openapi fetch request: %w", err)
 		}
 		if s.config != nil && strings.TrimSpace(s.config.UserAgent) != "" {
 			req.Header.Set("User-Agent", s.config.UserAgent)
@@ -146,7 +146,7 @@ func (s *OpenAPIScraper) readSpec(ctx context.Context, source *Source) ([]byte,
 
 		resp, err := s.client.Do(req)
 		if err != nil {
-			return nil, "", err
+			return nil, "", fmt.Errorf("fetch openapi spec from %s: %w", rawPath, err)
 		}
 		defer resp.Body.Close()
 		if resp.StatusCode < 200 || resp.StatusCode >= 300 {
@@ -154,14 +154,14 @@ func (s *OpenAPIScraper) readSpec(ctx context.Context, source *Source) ([]byte,
 		}
 		body, err := io.ReadAll(io.LimitReader(resp.Body, 10<<20))
 		if err != nil {
-			return nil, "", err
+			return nil, "", fmt.Errorf("read openapi response body from %s: %w", rawPath, err)
 		}
 		return body, rawPath, nil
 	}
 
 	b, err := os.ReadFile(rawPath)
 	if err != nil {
-		return nil, "", err
+		return nil, "", fmt.Errorf("read openapi file %q: %w", rawPath, err)
 	}
 	return b, "file://" + rawPath, nil
 }
@@ -214,7 +214,7 @@ func parseOpenAPISpec(raw []byte) (*openAPISpec, error) {
 	var spec openAPISpec
 	if err := json.Unmarshal(raw, &spec); err != nil {
 		if yamlErr := yaml.Unmarshal(raw, &spec); yamlErr != nil {
-			return nil, fmt.Errorf("invalid openapi content: %w", err)
+			return nil, fmt.Errorf("invalid openapi content (json: %v; yaml: %w)", err, yamlErr)
 		}
 	}