64898b2c79
Some checks failed
Code scanning / CodeQL (push) Failing after 15s
Zulip production suite / Ubuntu 22.04 production build (push) Failing after 26s
Zulip production suite / Debian 12 production install with custom db name and user (push) Has been skipped
Zulip production suite / Ubuntu 22.04 production install and PostgreSQL upgrade with pgroonga (push) Has been skipped
Zulip production suite / Ubuntu 24.04 production install (push) Has been skipped
Zulip production suite / Ubuntu 26.04 production install (push) Has been skipped
Zulip production suite / Debian 13 production install (push) Has been skipped
Zulip production suite / 7.0 Version Upgrade (push) Has been skipped
Zulip production suite / 8.0 Version Upgrade (push) Has been skipped
Zulip production suite / 6.0 Version Upgrade (push) Has been skipped
Zulip production suite / 10.0 Version Upgrade (push) Has been skipped
Zulip production suite / 9.0 Version Upgrade (push) Has been skipped
Zulip production suite / 12.0 Version Upgrade (push) Has been skipped
Zulip production suite / 11.0 Version Upgrade (push) Has been skipped
GitHub Actions Security Analysis with zizmor / zizmor (push) Failing after 3s
Zulip CI / Debian 12 (Python 3.11, backend + documentation) (push) Failing after 26s
Zulip CI / Ubuntu 22.04 (Python 3.10, backend + frontend) (push) Failing after 3s
Zulip CI / Ubuntu 24.04 (Python 3.12, backend) (push) Failing after 25s
Zulip CI / Ubuntu 26.04 (Python 3.14, backend) (push) Failing after 25s
Zulip CI / Debian 13 (Python 3.13, backend) (push) Failing after 28s
Zulip production suite / Required jobs (push) Has been cancelled
Zulip CI / Required jobs (push) Has been cancelled
API Documentation Update Check / check-feature-level-updated (push) Has been cancelled
API Documentation Update Check / notify-if-api-docs-changed (push) Has been cancelled
41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
# Onboarding Steps
|
|
|
|
Onboarding steps introduce users to important UI elements. They are an
|
|
effective means of providing context where Zulip's UI may not be self-evident.
|
|
|
|
Currently, an onboarding step is a one-time notice in the form of a banner or modal.
|
|
Previously, hotspots were another type of onboarding step available.
|
|
|
|
## Configuring a New Onboarding Step
|
|
|
|
...is easy! If you think highlighting a certain UI element would improve
|
|
Zulip's user experience, we welcome you to [open an issue](https://github.com/zulip/zulip/issues/new?title=onboarding_step_request:) for discussion.
|
|
|
|
### Step 1: Add the Onboarding Step Name
|
|
|
|
In `zerver/lib/onboarding_steps.py`, add the new onboarding step name to the
|
|
`ONE_TIME_NOTICES` list:
|
|
|
|
```python
|
|
ONE_TIME_NOTICES: List[OneTimeNotice] = [
|
|
...
|
|
OneTimeNotice(
|
|
name="Provide a concise name",
|
|
),
|
|
]
|
|
```
|
|
|
|
### Step 2: Display the Onboarding Step
|
|
|
|
When the UI element that is not self-evident appears, use the
|
|
`ONE_TIME_NOTICES_TO_DISPLAY` data structure from `web/src/onboarding_steps.ts`
|
|
and the onboarding step name added in **Step 1** to determine if the
|
|
one-time notice should be displayed. Display the notice.
|
|
|
|
### Step 3: Mark the Onboarding Step as Read
|
|
|
|
Once the notice is displayed, use the `post_onboarding_step_as_read` function
|
|
from `web/src/onboarding_steps.ts` to mark the onboarding step as read.
|
|
This will update `ONE_TIME_NOTICES_TO_DISPLAY` so that the user will not see
|
|
the notice again.
|