zulip/zulip

Rename `dm-including` search filter to `dm-with`

Open

#34,932 opened on Jun 18, 2025

View on GitHub
 (17 comments) (0 reactions) (0 assignees)Python (7,339 forks)batch import
area: searchhelp wanted

Repository metrics

Stars
 (19,672 stars)
PR merge metrics
 (Avg merge 36d 6h) (110 merged PRs in 30d)

Description

As suggested at #design > Add mentions:user search filter #34751 @ 💬, dm-with is a better name for the filter currently called dm-including. We should rename it.

We should offer backwards compatibility like we do for stream:, where typing dm-including suggests dm-with.

All documentation (including ? menu and help center) should be updated.

Contributor guide

Research direction
Locate the existing `dm including` filter definition in the search code. Rename it and add an alias for backward compatibility. Update the frontend suggestion logic and all documentation.
Tech stack
pythonjavascript
Domain
backendfrontenddocumentation
Issue type
Refactor
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
PythonGit
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
80