docs: rewrite work item copy section for the unified copy flow

[sriramveeraghanta]

Description

Updates the Duplicate work items section of core-concepts/issues/overview to match the copy behavior that shipped recently. The "Copy in same project / Copy in different project" submenu has been replaced by a single Make a copy modal with a destination project picker, and the same-project and cross-project paths now follow one consistent spec.

The existing section documented the old submenu and was wrong about the behavior in both directions:

• It said a same-project copy "maintains the same title" — the title now gets a (Copy) suffix.
• It described a cross-project copy as only adapting "the destination project's identifier format and default state", while omitting that assignees, labels, modules, cycle, estimate, and every custom property value are cleared. That omission is the part users would actually get burned by.

What changed

• One flow, not two — the ### Copy in same project / ### Copy in different project sub-sections are gone, replaced by a description of the single modal with its destination picker defaulting to the current project.
• A comparison table covering every field, same project vs. different project. The two cases differ enough that prose would bury it.
• A one-line rationale for the cross-project clearing (labels, modules, cycles and estimates are project-scoped), so it reads as a design decision rather than a gap.
• A tip on the custom-properties-into-description fallback, since users would otherwise assume the values vanished.
• Notes and limits — the epic constraint on cross-project copies, archived items copying as active, and a pointer to bulk operations.
• Mentions the Duplicate of backlink relation.

Not covered here

Two things I deliberately left out, flagging for a reviewer's call:

1. This section carries a Pro badge and documents the Pro behavior only. Community projects still use the older prefilled-create-modal flow, which behaves differently — that may warrant its own note.
2. core-concepts/issues/bulk-ops doesn't list copy among its bulk operations at all. Now that bulk copy shares the same semantics, that page is arguably missing an entry — linked to from here, but not edited, as it was outside the scope of this change.

Anchors

#copy-in-same-project and #copy-in-different-project no longer exist. Nothing in the source tree links to them (grepped), but external inbound links will now land at the page top rather than the section.

Verification

pnpm fix:format runs clean.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jul 28, 2026 12:17pm

[coderabbitai]

📝 Walkthrough

Walkthrough

Changes

Work item copy documentation

Layer / File(s)	Summary
Copy flow and behavior rules docs/core-concepts/issues/overview.md	Documents the “Make a copy” flow, destination project selection, copied fields, cross-project custom property handling, duplicate relationships, and eligibility and bulk-copy constraints.

Estimated code review effort: 2 (Simple) | ~10 minutes

Suggested reviewers: danciaclara

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly reflects the main documentation change: rewriting the work item copy section for the unified copy flow.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/work-item-copy-behavior

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/core-concepts/issues/overview.md`:
- Line 141: Update the duplicate-section statement in
docs/core-concepts/issues/overview.md so it does not claim bulk copying follows
documented single-copy rules unless docs/core-concepts/issues/bulk-ops.md is
expanded to cover Make a copy and its rules; prefer either adding that complete
bulk-copy documentation or changing the linked text to a general bulk-operations
overview.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d3a42baf-b49e-4070-9afc-60b65dffde13

📥 Commits

Reviewing files that changed from the base of the PR and between f3804cb and d15c728.

📒 Files selected for processing (1)

• docs/core-concepts/issues/overview.md