Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Implement Quick Tutorial Flow with Noun Annotation Logic Rules

未关闭
#649 1 条评论 1 个 reaction 已指派 1 人 在 GitHub 查看

@prince-0408 已经在做这个了。

开始于 2026年5月3日。

  • #650 来自 @prince-0408 —— 未关闭

评估

这个 Issue 还没有评估数据。

描述

-next release-
Terms
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 InstallationVC to 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]
主要语言
Swift
星标
171
派生
109
PR 合并指标
30 天内没有已合并 PR

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

scribe-org/Scribe-iOS 的其他 Issue

查看 scribe-org/Scribe-iOS 的全部 Issue

相似的 Issue

更多 Swift Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。