## Feature Request: Adjustable Word Learning Threshold

[alpha-t12]

Description

Currently, HeliBoard requires typing a new word 3 times before it's learned and added to suggestions. This is inconvenient compared to Gboard which learns after 2 times or even after accepting once from the suggestion bar.

Current Behavior

Method 1 (typing repeatedly):

• Type a new word: 1st time → not learned
• Type the same word: 2nd time → not learned
• Type the same word: 3rd time → finally learned ✓

Method 2 (accepting from suggestion):

• Type a new word → appears underlined or in suggestions
• Tap to accept it → still not learned ✗
• Must type it 2 more times to be learned

Requested Feature

Add settings to control learning behavior:

Settings → Text Correction → Learning ☑ Auto-learn threshold: [1 / 2 / 3 / 5 times typed] Default: 2 (like Gboard)

☑ Learn on first acceptance When enabled, accepting a word from suggestions immediately adds it to learned words Default: enabled (like Gboard)

Comparison with Gboard

Action	Gboard	HeliBoard (current)	HeliBoard (requested)
Type word 2x	Learned ✓	Not learned ✗	Learned ✓
Accept from suggestions	Learned ✓	Not learned ✗	Learned ✓
Type word 3x	Learned ✓	Learned ✓	Learned ✓

Use Case

• Typing uncommon names, brand names, or technical terms
• Having to type 3 times is frustrating and wastes time
• Accepting a word should signal "yes, I want this word"
• Gboard's behavior feels more natural and responsive

Benefits

• Faster learning matches user expectations
• Better UX - accepting a word = confirming you want it learned
• Flexibility - users can choose conservative (3x) or aggressive (1x accept) learning
• Industry standard - matches Gboard and SwiftKey behavior

Technical Implementation

This likely involves:

1. Adjusting frequency threshold in UserHistoryDictionary
2. Adding flag to learn immediately when user accepts a suggestion
3. Making threshold configurable via settings

Alternative (Simpler Implementation)

If full configurability is too complex:

• Reduce default threshold from 3 → 2 typed occurrences
• Auto-learn on first suggestion acceptance (most important!)

---

This would significantly improve the learning experience and bring HeliBoard closer to Gboard's excellent prediction system.