From 1fa954b74b5fd14e639bc2de00881e2e8e3316e9 Mon Sep 17 00:00:00 2001 From: bircni Date: Mon, 12 Oct 2026 20:33:45 +0200 Subject: [PATCH] docs: drop planning IDs from code comments Signed-off-by: bircni --- internal/app/app.go | 6 +++--- internal/app/checkout.go | 2 +- internal/app/issues.go | 2 +- internal/services/label_selection.go | 4 ++-- internal/services/milestone_selection.go | 2 +- 5 files changed, 8 insertions(+), 8 deletions(-) diff --git a/internal/app/app.go b/internal/app/app.go index c895fcc0..2bd3149c 100644 --- a/internal/app/app.go +++ b/internal/app/app.go @@ -203,14 +203,14 @@ func NewRoot(deps Dependencies) *cobra.Command { return root } -// rootGroups places the core and Actions commands in their root help groups (D26); every other +// rootGroups places the core and Actions commands in their root help groups; every other // command is additional. var rootGroups = map[string]string{ "auth": "core", "issue": "core", "org": "core", "pr": "core", "release": "core", "repo": "core", "run": "actions", "secret": "actions", "variable": "actions", "workflow": "actions", } -// verbAliases are the gh-style short names that every command with a common verb accepts (D6). +// verbAliases are the gh-style short names that every command with a common verb accepts. // Commands add other gh verbs, such as new, co, add and get, to their own Aliases. var verbAliases = map[string]string{"list": "ls", "delete": "rm"} @@ -227,7 +227,7 @@ func addVerbAliases(cmd *cobra.Command) { } // acceptPlurals lets the flags of cmd be named in the plural, such as --add-labels for the gh name -// --add-label (D8), without showing the plural in help. +// --add-label, without showing the plural in help. func acceptPlurals(cmd *cobra.Command) { names := map[string]bool{} cmd.Flags().VisitAll(func(flag *pflag.Flag) { names[flag.Name] = true }) diff --git a/internal/app/checkout.go b/internal/app/checkout.go index 0cd4ce02..28584326 100644 --- a/internal/app/checkout.go +++ b/internal/app/checkout.go @@ -161,7 +161,7 @@ $ tea pr checkout 13 --update` return cmd } -// checkoutBranchName names the local branch for a pull request (D13): its head branch name when +// checkoutBranchName names the local branch for a pull request: its head branch name when // that is free or already at the head, else OWNER/BRANCH for a fork, else pr/NUMBER. A branch that // an earlier checkout of the same pull request created is reused, so that --update can advance it. func (a *application) checkoutBranchName(ctx context.Context, t target, pull services.Pull) string { diff --git a/internal/app/issues.go b/internal/app/issues.go index f49dd5e6..70261653 100644 --- a/internal/app/issues.go +++ b/internal/app/issues.go @@ -528,7 +528,7 @@ type metadataFlags struct { } // register adds the flags under their gh names, --add-label and so on, and keeps the plural -// names working (D8). +// names working. func (f *metadataFlags) register(cmd *cobra.Command) { flags := cmd.Flags() flags.StringSliceVar(&f.addLabels, "add-label", nil, "Add labels by `name`; prefix repo: or org: to disambiguate") diff --git a/internal/services/label_selection.go b/internal/services/label_selection.go index edc2c451..23aa239e 100644 --- a/internal/services/label_selection.go +++ b/internal/services/label_selection.go @@ -19,13 +19,13 @@ func (s Labels) Scope() string { return s.Repository } -// finder addresses the labels of the scope by ID or name (D10); byName matches numeric values as +// finder addresses the labels of the scope by ID or name; byName matches numeric values as // names only. func (s Labels) finder(byName bool) NameOrID[Label] { return NameOrID[Label]{Kind: "label", Scope: s.Scope(), ID: func(l Label) int64 { return l.ID }, Name: func(l Label) string { return l.Name }, ByName: byName} } -// Find returns the labels of the scope that raws address, each by ID or name (D10); byName matches +// Find returns the labels of the scope that raws address, each by ID or name; byName matches // numeric values as names only. func (s Labels) Find(ctx context.Context, raws []string, byName bool) ([]Label, error) { items, err := s.All(ctx) diff --git a/internal/services/milestone_selection.go b/internal/services/milestone_selection.go index 4b315d39..c6952f9c 100644 --- a/internal/services/milestone_selection.go +++ b/internal/services/milestone_selection.go @@ -14,7 +14,7 @@ func (s Milestones) All(ctx context.Context) ([]Milestone, error) { } // Find returns the milestones that raws address among the open and closed milestones, each by ID -// or title (D10); byName matches numeric values as titles only. +// or title; byName matches numeric values as titles only. func (s Milestones) Find(ctx context.Context, raws []string, byName bool) ([]Milestone, error) { items, err := s.All(ctx) if err != nil {