docs: Improve doc comments

Author: macie

hackernews.go

@@ -25,8 +25,7 @@ type HackerNewsResponse struct {
 }
 
 // SearchHackerNews query HN Search API for given prompt. It returns list of
-// stories which contains comments sorted by relevance, then popularity, then
-// number of comments.
+// discussions sorted by relevance, then popularity, then number of comments.
 //
 // See: https://hn.algolia.com/api
 func SearchHackerNews(ctx context.Context, client http.Client, query string) ([]Discussion, error) {

lobsters.go

@@ -9,8 +9,8 @@ import (
 	"github.com/macie/opinions/http"
 )
 
-// SearchLobsters query lobster search engine for given prompt. It returns list
-// of stories which contains comments sorted by relevance.
+// SearchLobsters query Lobsters search engine for given prompt. It returns list
+// of discussions sorted by relevance.
 func SearchLobsters(ctx context.Context, client http.Client, query string) ([]Discussion, error) {
 	discussions := make([]Discussion, 0)
 	searchURL := "https://lobste.rs/search?what=stories&order=relevance&q="