darktable-org / darktable-org/darktable

Duplicate Manager needs better documentation and messages for deletion of duplicates

Open
#19,567 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

no-issue-activity
Dominant language
C
Stars
13.1k
Forks
1.4k
Avg merge
22h 14m
Merged PRs (30d)
198

Description

Is your feature request related to a problem? Please describe.
The manual for darktable does not mention what happens when you delete a duplicate (using the "x" in the upper right hand corner of an image in the duplicate manager). So it was unclear to me what would happen when I did that until I experimented with it.

Furthermore the message that the duplicate manager uses sounds like it will be deleting the RAW file from the disk, but that only affects the duplicate. It would be better if the message made it clear what was actually being deleted (just the .xmp file for the duplicate, I believe).

Describe the solution you'd like
The documentation should describe what happens when a duplicate is deleted and the message attached to the confirmation should be clearer about what is being deleted.

I also expected the duplicate manager to be available in the lightable view, but it isn't.

Alternatives
One could copy the relevant files first and then try out deletion in the duplicate manager to see what happens.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the duplicate manager entry point and the manual section covering duplicate deletion. Confirm what the upper-right “x” deletes and review the confirmation message’s current wording, then update the documentation and message so the affected duplicate and file are explicit. Check whether lighttable availability is part of this issue or a separate request.

Written by the indexing model from the issue text.

Assessment

Tech stack
c
Domain
desktop-dev, documentation
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.