docs: improve displaying GitHub API links on pkg.go.dev

Author: alexandear

github/activity_events.go

@@ -143,6 +143,7 @@ func (s *ActivityService) ListEventsForOrganization(ctx context.Context, org str
 // true, only public events will be returned.
 //
 // GitHub API docs: https://docs.github.com/rest/activity/events#list-events-for-the-authenticated-user
+//
 // GitHub API docs: https://docs.github.com/rest/activity/events#list-public-events-for-a-user
 //
 //meta:operation GET /users/{username}/events
@@ -177,6 +178,7 @@ func (s *ActivityService) ListEventsPerformedByUser(ctx context.Context, user st
 // true, only public events will be returned.
 //
 // GitHub API docs: https://docs.github.com/rest/activity/events#list-events-received-by-the-authenticated-user
+//
 // GitHub API docs: https://docs.github.com/rest/activity/events#list-public-events-received-by-a-user
 //
 //meta:operation GET /users/{username}/received_events

github/activity_star.go

@@ -69,6 +69,7 @@ type ActivityListStarredOptions struct {
 // will list the starred repositories for the authenticated user.
 //
 // GitHub API docs: https://docs.github.com/rest/activity/starring#list-repositories-starred-by-a-user
+//
 // GitHub API docs: https://docs.github.com/rest/activity/starring#list-repositories-starred-by-the-authenticated-user
 //
 //meta:operation GET /user/starred

github/activity_watching.go

@@ -55,6 +55,7 @@ func (s *ActivityService) ListWatchers(ctx context.Context, owner, repo string,
 // the empty string will fetch watched repos for the authenticated user.
 //
 // GitHub API docs: https://docs.github.com/rest/activity/watching#list-repositories-watched-by-a-user
+//
 // GitHub API docs: https://docs.github.com/rest/activity/watching#list-repositories-watched-by-the-authenticated-user
 //
 //meta:operation GET /user/subscriptions

github/apps.go

@@ -215,6 +215,7 @@ func (i Installation) String() string {
 // (e.g., https://github.com/settings/apps/:app_slug).
 //
 // GitHub API docs: https://docs.github.com/rest/apps/apps#get-an-app
+//
 // GitHub API docs: https://docs.github.com/rest/apps/apps#get-the-authenticated-app
 //
 //meta:operation GET /app

github/apps_marketplace.go

@@ -90,6 +90,7 @@ type MarketplacePurchaseAccount struct {
 // ListPlans lists all plans for your Marketplace listing.
 //
 // GitHub API docs: https://docs.github.com/rest/apps/marketplace#list-plans
+//
 // GitHub API docs: https://docs.github.com/rest/apps/marketplace#list-plans-stubbed
 //
 //meta:operation GET /marketplace_listing/plans
@@ -118,6 +119,7 @@ func (s *MarketplaceService) ListPlans(ctx context.Context, opts *ListOptions) (
 // ListPlanAccountsForPlan lists all GitHub accounts (user or organization) on a specific plan.
 //
 // GitHub API docs: https://docs.github.com/rest/apps/marketplace#list-accounts-for-a-plan
+//
 // GitHub API docs: https://docs.github.com/rest/apps/marketplace#list-accounts-for-a-plan-stubbed
 //
 //meta:operation GET /marketplace_listing/plans/{plan_id}/accounts
@@ -146,6 +148,7 @@ func (s *MarketplaceService) ListPlanAccountsForPlan(ctx context.Context, planID
 // GetPlanAccountForAccount get GitHub account (user or organization) associated with an account.
 //
 // GitHub API docs: https://docs.github.com/rest/apps/marketplace#get-a-subscription-plan-for-an-account
+//
 // GitHub API docs: https://docs.github.com/rest/apps/marketplace#get-a-subscription-plan-for-an-account-stubbed
 //
 //meta:operation GET /marketplace_listing/accounts/{account_id}
@@ -170,6 +173,7 @@ func (s *MarketplaceService) GetPlanAccountForAccount(ctx context.Context, accou
 // ListMarketplacePurchasesForUser lists all GitHub marketplace purchases made by a user.
 //
 // GitHub API docs: https://docs.github.com/rest/apps/marketplace#list-subscriptions-for-the-authenticated-user
+//
 // GitHub API docs: https://docs.github.com/rest/apps/marketplace#list-subscriptions-for-the-authenticated-user-stubbed
 //
 //meta:operation GET /user/marketplace_purchases

github/gists.go

@@ -97,6 +97,7 @@ type GistListOptions struct {
 // user.
 //
 // GitHub API docs: https://docs.github.com/rest/gists/gists#list-gists-for-a-user
+//
 // GitHub API docs: https://docs.github.com/rest/gists/gists#list-gists-for-the-authenticated-user
 //
 //meta:operation GET /gists

github/issues.go

@@ -160,6 +160,7 @@ type IssueType struct {
 // repositories.
 //
 // GitHub API docs: https://docs.github.com/rest/issues/issues#list-issues-assigned-to-the-authenticated-user
+//
 // GitHub API docs: https://docs.github.com/rest/issues/issues#list-user-account-issues-assigned-to-the-authenticated-user
 //
 //meta:operation GET /issues

github/issues_comments.go

@@ -55,6 +55,7 @@ type IssueListCommentsOptions struct {
 // number of 0 will return all comments on all issues for the repository.
 //
 // GitHub API docs: https://docs.github.com/rest/issues/comments#list-issue-comments
+//
 // GitHub API docs: https://docs.github.com/rest/issues/comments#list-issue-comments-for-a-repository
 //
 //meta:operation GET /repos/{owner}/{repo}/issues/comments

github/orgs.go

@@ -194,6 +194,7 @@ func (s *OrganizationsService) ListAll(ctx context.Context, opts *OrganizationsL
 // organizations for the authenticated user.
 //
 // GitHub API docs: https://docs.github.com/rest/orgs/orgs#list-organizations-for-a-user
+//
 // GitHub API docs: https://docs.github.com/rest/orgs/orgs#list-organizations-for-the-authenticated-user
 //
 //meta:operation GET /user/orgs

github/orgs_members.go

@@ -72,6 +72,7 @@ type ListMembersOptions struct {
 // public members; otherwise, it will only return public members.
 //
 // GitHub API docs: https://docs.github.com/rest/orgs/members#list-organization-members
+//
 // GitHub API docs: https://docs.github.com/rest/orgs/members#list-public-organization-members
 //
 //meta:operation GET /orgs/{org}/members
@@ -237,6 +238,7 @@ func (s *OrganizationsService) ListOrgMemberships(ctx context.Context, opts *Lis
 // authenticated user.
 //
 // GitHub API docs: https://docs.github.com/rest/orgs/members#get-an-organization-membership-for-the-authenticated-user
+//
 // GitHub API docs: https://docs.github.com/rest/orgs/members#get-organization-membership-for-a-user
 //
 //meta:operation GET /orgs/{org}/memberships/{username}
@@ -268,6 +270,7 @@ func (s *OrganizationsService) GetOrgMembership(ctx context.Context, user, org s
 // authenticated user.
 //
 // GitHub API docs: https://docs.github.com/rest/orgs/members#set-organization-membership-for-a-user
+//
 // GitHub API docs: https://docs.github.com/rest/orgs/members#update-an-organization-membership-for-the-authenticated-user
 //
 //meta:operation PUT /orgs/{org}/memberships/{username}