Skip to content

docs: refresh the 1.44 screenshots and the prose they carry - #142

Merged
kelsos merged 1 commit into
rotki:mainfrom
kelsos:docs/refresh-1440-screenshots
Aug 26, 2026
Merged

kelsos merged 1 commit into
rotki:mainfrom
kelsos:docs/refresh-1440-screenshots

Conversation

@kelsos

@kelsos kelsos commented Aug 26, 2026

Copy link
Copy Markdown
Member

Brings the usage guides in line with what 1.44 actually renders. Images go from 208 to 218: 13 new, 3 removed, the rest recaptured against a stack built from the v1.44.0 tag.

Three images are deleted, not reshot

The UI they documented no longer exists. Neither the banner headline nor the duplicate-count strings survive in the app's en.json, and the three-dot menu no longer offers Check internal tx conflicts:

Removed Why
internal_tx_conflicts_banner.webp the issues alert banner is gone
duplicate_custom.webp the duplicates banner is gone
internal_tx_conflicts_menu.webp the menu entry is gone

All three were consolidated into the actions center in 1.44, which the remaining images now show. The three passages describing them are rewritten.

A rename is not a recapture

Eleven images under history/issues/ had been moved there from history/events/ without being retaken. They still showed 1.41.4.dev and 1.42.1 builds, a Combined filters control that no longer exists, and transient sync banners baked into frame.

Worth flagging for the review: every gate passed the whole time. Reference resolution, orphans and placement were all green while three images documented deleted features. Nothing detects a stale image today.

Dialogs are now cropped to their own bounds rather than shot as full viewports, per the overlay convention.

Prose corrections

Found by putting the screen next to the code, not by reading the changelog:

  • The conflicts filter is the shared pill bar (a Chain pill and a Date pill). The "combined filters" it replaced is gone.
  • The two conflict settings default to 100 and 15 minutes, not 20 and 60. The old numbers matched the frontend's constants, which disagree with the backend's — see the note below.
  • Those settings are titled differently on the general settings page (Internal transactions to repull, Conflict repull frequency), which the page now says.
  • The address alias priority list is not opt-in, and its default order is the one the backend ships.
  • GNS names, the notification tab order, the browser-only help entries and the accounting rules pills are restated to match the app.
  • Recommended asset movement matches are marked only when a candidate stands out, so that is now described as conditional. The empty state and its Widen search button are documented for the first time.

The issue category table gains an action column, premium markers, and a note that ignoring items changes a row's action rather than hiding it.

CI

A new check that the links the app makes into these docs resolve, plus tightening of the image and anchor gates.


Two app defects found while capturing (not fixed here)

Both verified against v1.44.0 and present on bugfixes:

  1. The Pending tab returns every unfixed conflict. rotkehlchen/db/filtering.py has if failed: over a failed: bool = False parameter, so failed=false is indistinguishable from "not supplied" and no filter is applied. Confirmed at the API boundary: ?failed=false&fixed=false returns 11 where it should return 0, while ?failed=true and ?fixed=true are both correct.

  2. Frontend and backend disagree on both conflict-setting defaults, and the reset control writes the frontend value — so "reset to default" sets a non-default.

    Setting Backend Frontend
    internal_txs_to_repull 100 20
    repull frequency 900s (15 min) 3600s (60 min)

Still open

  • 181 of 218 images have never been audited. history/events alone holds 22, and it is the same area 1.44 churned hardest. Given roughly a quarter of what was inspected here documented removed features, that backlog likely hides more of the same.
  • Two captures remain blocked: the Gnosis recommended-settings dialog (fires at login only, so a resumed session cannot reach it) and the event-to-rule jump (no page references it yet).

Brings the usage guides in line with what 1.44 actually renders. Images go
from 208 to 218: 13 new, 3 removed, the rest recaptured against a stack
built from the v1.44.0 tag.

Images

The issues content moves to its own page with its images beside it. Three
images are deleted rather than reshot, because the UI they documented no
longer exists: the alert banner that announced detected issues, the
duplicate banner, and the three-dot menu entry for the conflicts dialog.
All three were consolidated into the actions center in 1.44, which the
remaining images now show.

Eleven images under history/issues had been moved there from
history/events without being retaken, so they still showed 1.41.4.dev and
1.42.1 builds, a "Combined filters" control that no longer exists, and
transient sync banners. A rename is not a recapture, and no gate can see
the difference: every check passed the whole time.

Dialogs are cropped to their own bounds rather than shot as full viewports,
which is what the overlay convention asks for and what the old images in
this set were ignoring.

Prose

Corrections found by putting the screen next to the code rather than
reading the changelog:

- The conflicts filter is the shared pill bar with a Chain pill and a Date
  pill; the "combined filters" it replaced is gone.
- The two conflict settings default to 100 and 15 minutes, not 20 and 60.
  The old numbers matched the frontend's constants, which disagree with the
  backend's. Those settings are titled differently on the general settings
  page, which the page now says.
- The address alias priority list is not opt-in, and its default order is
  the one the backend ships.
- GNS names, the notification tab order, the browser-only help entries and
  the accounting rules pills are restated to match the app.
- Recommended asset movement matches are marked only when a candidate
  stands out, so that is described as conditional. The empty state and its
  Widen search button are documented for the first time.

The issue category table gains an action column, premium markers, and a
note that ignoring items changes a row's action rather than hiding it.

CI

A new check that the links the app makes into these docs resolve, plus
tightening of the image and anchor gates. None of them can detect a stale
image; that gap is still open.
@kelsos
kelsos merged commit c310f80 into rotki:main Aug 26, 2026
5 checks passed
@kelsos
kelsos deleted the docs/refresh-1440-screenshots branch August 26, 2026 09:44

This branch was previously deployed

1 inactive deployment
github-pages — c310f80b Deployed Aug 26, 2026 by kelsos via deploy #226
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant