Implement Quick Tutorial Flow with Noun Annotation Logic Rules
Valutazione
Questa issue non è ancora stata valutata.
Descrizione
Terms
- I have searched open and closed feature requests
- I agree to follow Scribe-iOS' Code of Conduct
Description
Description
The "Quick tutorial" button in the Installation tab currently has a blank action — clicking it does nothing. This issue tracks implementing the full interactive tutorial flow as designed in Figma, along with the logic rules for which chapters to show based on installed keyboards.
What Needs to Be Done
- Wire the "Quick tutorial" button in
InstallationVCto open the tutorial flow - Entry screen with tip card, description, chapter list, and "Start full tutorial" button
- Individual chapter screens with interactive "Try it here" text fields so users actually practice using the keyboard — not just read about commands
- Real-time correct/incorrect feedback on interactive steps
- Hide Noun annotation chapter when only English keyboard is installed
- Show "Non-Scribe keyboard" warning when a non-Scribe keyboard is active
Tutorial Chapters
| Chapter | Visibility | Interactive Steps |
|---|---|---|
| Noun annotation | Hidden for English-only users | Write "Vater" then "Mutter" — observe gender tags M/F on keyboard top bar |
| Word translation | Always shown | Use the Scribe key to translate a word |
| Verb conjugation | Always shown | Use the Scribe key to conjugate a verb |
| Noun plurals | Always shown | Use the Scribe key to get a noun plural |
Noun Annotation Logic Rules
Since English nouns have no grammatical gender, showing the Noun annotation chapter to English-only users is not sensible.
| Installed Keyboards | Noun Annotation Shown? |
|---|---|
| None installed | ✅ Yes (user may install later) |
| Only English | ❌ No |
| English + any gender-language | ✅ Yes |
| Any gender-language only | ✅ Yes |
Languages that support noun-gender annotations: German, Spanish, French, Portuguese, Russian, Italian, Swedish, Norwegian, Danish, Hebrew, Indonesian
Notes
- Keyboard detection should read installed keyboards from
UserDefaults - Noun annotation has 2 interactive steps (Vater → Mutter) — other chapters are instruction-only
- Wrong keyboard detection should check on screen appear and show guidance to switch to a Scribe keyboard
Related
- Figma design: [Here]
- Lingua principale
- Swift
- Stelle
- 171
- Fork
- 109
- Metriche di merge delle PR
- Nessuna PR unita negli ultimi 30g
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di scribe-org/Scribe-iOS
-
Grammar checker POCForse di nuovo libera @henrikth93 l’ha presa 72 giorni fa e non c’è nessuna pull request aperta. Apertaquestion
scribe-org/Scribe-iOS#662 · 1 assegnatario ·
-
Settings menu look bad on iPad Air 11-inchForse già presa @prince-0408 l’ha presa 90 giorni fa. Apertadesign
scribe-org/Scribe-iOS#659 · 3 commenti · 1 assegnatario ·
-
Show closest word suggestion when translation or conjugation is invalidForse già presa @prince-0408 l’ha presa 202 giorni fa. Aperta
Difficoltà 4/5 3-5 giorni Idoneità per principianti 68/100
scribe-org/Scribe-iOS#640 · 1 commento ·
-
Add haptic feedback on key press for Scribe keyboardsForse già presa @prince-0408 l’ha presa 203 giorni fa. Aperta
scribe-org/Scribe-iOS#638 · 1 reazione · 1 assegnatario ·
-
feat: add offline network indicator on download screenForse già presa @prince-0408 l’ha presa 203 giorni fa. Apertahelp wanted
scribe-org/Scribe-iOS#637 · 1 commento · 1 assegnatario ·
Tutte le issue di scribe-org/Scribe-iOS
Issue simili
-
bug good first issue help wanted
Difficoltà 2/5 1-3 ore Idoneità per principianti 63/100
marcovisona/arca#5 ·
-
enhancement good first issue
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
luis-guillen/airy#2 ·
-
accessibility bug medium-priority mobile
Difficoltà 2/5 1-3 ore Idoneità per principianti 83/100
lognorman20/monaco#6247 ·
-
documentation windows
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
521xueweihan/HelloGitHub#4060 ·