darktable-org / darktable-org/darktable

Show a welcome screen on new installs and upgrades

Open
#19,589 9 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

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

Description

Two things I (and many others, no doubt) have noticed: New users very often don't realise there's a manual, or at least think they don't need it, and current users don't always realise they are on a new version with new features, or don't know where the release announcement is.

So my proposal is to add a pop-up screen when darktable is launched for the first time after being installed or upgraded, that has a section for new users that encourages them to look at the FAQ and manual, and another section that at a minimum links to the release notes, but maybe even includes the headlines.

This should only be shown once, unless the user specifically ticks the box to have it shown next launch, but there should be a button in the about dialog to get to it as well.

So it would look something like this:

Welcome to darktable X.Y.Z

New users

To help you get started, make sure to look at the FAQ and read the overview section of the manual.

  • FAQ
  • Manual

New in this version

  • Release notes

[ ] Show this screen on next launch

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 by reviewing darktable’s startup flow and the existing About dialog, since the issue requires a first-launch or post-upgrade screen plus an About-dialog entry point. Confirm how the FAQ, manual, and release notes are linked. Done means the screen appears only as specified, supports the checkbox behavior, and provides the requested links and version information.

Written by the indexing model from the issue text.

Assessment

Tech stack
c
Domain
desktop
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 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.