a-b-street/abstreet

Add a tutorial task to use the minimap

Open

#611 opened on Apr 18, 2021

View on GitHub
 (1 comment) (1 reaction) (0 assignees)Rust (256 forks)batch import
good first issue

Repository metrics

Stars
 (6,779 stars)
PR merge metrics
 (No merged PRs in 30d)

Description

From #610, Michael's idea to teach how to navigate with the minimap, and also reinforce the use of layers:

The point of the minimap is that you can navigate relatively long distances quickly, while staying zoomed in. So, we need to observe something in detail (zoomed in), over a vast area. Could we do some kind of "Where's Wally?" And maybe Wally only likes to hang out at certain elevations.

The tutorial code (https://github.com/a-b-street/abstreet/blob/master/game/src/sandbox/gameplay/tutorial.rs) is on the more complex side, but this'd make a decent first issue to learn the UI.

Contributor guide

Research direction
Study the existing tutorial code at game/src/sandbox/gameplay/tutorial.rs to understand the structure, then implement a new task that teaches minimap navigation and layer usage, perhaps by hiding a character at a specific elevation.
Tech stack
rust
Domain
developer experience
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
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
Rust
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75