Skip to content

Practical Tips

This guide collects practical tips that help instructors and admins save time after they know the basics.

Flexible Question Ideas

Dynamic Question Variations

The Students answer in setting lets you use the same question types in different ways:

Ideas:

  • Reverse translation: Show the Ojibwe word and ask students to answer in English.
  • Reading comprehension: Ask a question in Ojibwe and have students answer in Ojibwe.
  • Supported practice: Give instructions in English while students practice Ojibwe answers.

Audio Recording Best Practices

For Pronunciation Questions:

  1. Record model audio at natural speaking pace
  2. Speak clearly but not unnaturally slow
  3. Re-record if you hear background noise
  4. Use consistent audio equipment (quality matters!)
  5. Record in a quiet room

Evaluating Student Audio:

  • Listen for: Vowel length, consonant clarity, tone
  • Provide audio feedback (model correct pronunciation)
  • Be encouraging (pronunciation is hard!)

Save Time While Building Content

Creating Multiple Questions Quickly

Pattern:

  1. Create first question completely
  2. Duplicate pattern for similar questions:
    • Create new question
    • Reuse translations from the dictionary
    • Change only the varied elements
  3. Use consistent naming (Question 1, Question 2, etc.)

Time Savers:

  • Translation Reuse: Add translations to the dictionary first, then select from dropdown in questions
  • Image Library: Upload images to assets, reuse across questions
  • Template Lessons: Create one perfect lesson, duplicate for other units

Batch Student Import (Manual Process)

While there's no CSV import, you can add students efficiently:

  1. Open "Add Student" dialog
  2. Add first student
  3. After the dialog closes, select Add Student again
  4. Repeat for all students
  5. Tip: Have list of names ready in a text file to copy/paste

Search & Filter Power Tips

  • Partial Match: Type "Joh" to find "John" and "Johnson"
  • Last Name Search: Type last name to find all students with that surname
  • Case Insensitive: "smith" finds "Smith", "SMITH", "smith"
  • Combined Filters: Use both Source Text and Translation filters simultaneously
  • Scope Toggle: Switch between "Mine" and "Community" to find shared translations
  • Audio Filter: Look for the play button icon to find entries with audio
  • Nested Search: When searching units, matching lessons will keep their parent unit visible
  • Search updates as you type
  • Clear Easily: Click X or delete text to show all again

Dashboard Numbers

Dashboard Metrics Explained

Active Students:

  • Count of students who have submitted at least one assignment in the last 30 days
  • Change Indicator: Shows whether activity increased or decreased compared with the previous period

Average Completion Rate:

  • Shows how much assigned work students are completing
  • Across all active students
  • Target: Aim for 70%+ for healthy engagement

Assignments Due:

  • Count of lessons with due dates in the next 7 days
  • Late Submissions Count: How many are already past due

Student Activity Feed:

What It Shows:

  • Recent submissions (last 24 hours)
  • Daily review completions
  • Streak milestones (3-day, 7-day, 30-day, etc.)
  • Updates as students complete work

Use Cases:

  • Spot check engagement during class
  • Celebrate achievements publicly
  • Identify students who haven't appeared recently (reach out!)

Keep Classes Organized

Check for Forgotten Content

Occasionally check:

  • Unpublished Units: Do you intend to keep them as drafts, or did you forget to publish?
  • Empty Units: Units with no lessons (delete or add content)
  • Unscheduled Lessons: Check calendar for lessons missing dates
  • Deleted Classes: Review periodically and restore only when needed

Student Data Management

Access Code Security:

  • Access codes are visible to instructors (by design)
  • Students should keep codes private
  • If compromised, you can edit student to generate new code (future feature)

Deactivated Students:

  • Keep deactivated (don't delete) to preserve submission history
  • Helpful for: Re-enrollment, historical data, grading records

Working with Other Tools

External Tools

Export Options (Manual):

  • Grades: View submissions, manually record scores in external gradebook
  • Attendance: Use activity feed to track engagement, record in SIS
  • Reports: Take screenshots of dashboard metrics for reporting

Import Options:

  • Student Lists: Manually add students (no CSV import currently)
  • Content: Use System Catalogue for pre-built lessons

Email Notifications

System-Sent Emails:

  1. User Invitations: Sent automatically when you add an organization user
  2. Password Reset: Sent when user clicks "Forgot Password"
  3. Setup Links: Sent when a new user needs to create their first password

Feedback Notifications:

  • Currently, students see feedback in-app (no email alerts)
  • Encourage students to check app regularly

Mobile App Integration

What Instructors Should Know

Student App Capabilities:

  • Login with Access Code (no email/password)
  • View available lessons (respects published status and available dates)
  • Complete lessons (all question types supported)
  • Daily Review (once per day)
  • View streaks and submission history
  • See feedback from instructors

App Updates:

  • Submissions appear in the web dashboard after students submit them
  • Feedback you provide appears in the mobile app
  • Publishing changes affect what students can see

Troubleshooting Student App Issues

Common Issues:

  1. "Lesson not showing": Check published status (unit AND lesson)
  2. "Can't log in": Verify access code is correct (case-sensitive!)
  3. "No Daily Review option": Student must complete at least one lesson first
  4. "Submission didn't save": Check student's internet connection, may need to retry

Security & Privacy

Who Can See What

Data Visibility:

  • Instructors: See only assigned classes and students
  • Admins: See all classes/students in their organization
  • Super Admins: See all organizations

Passwords and Sign-In

Best Practices:

  • Use strong passwords (8+ characters, mixed types)
  • Log out on shared computers
  • Don't share access codes publicly

Customization & Branding

Guidelines:

  • Format: JPEG, PNG, WebP, BMP, or TIFF
  • Size: Aim for 500x500 pixels (square aspect ratio)
  • File Size: Keep under 2MB for fast loading
  • Content: School logo, tribal emblem, or organization mark

Where It Appears:

  • Organization detail page (admins see it)
  • Future: Login page, student app (potential)

Lesson Customization

Personalizing Content:

  • Images: Use local landmarks, community photos, cultural context
  • Audio: Record in your voice, dialect, or elder's voice
  • Prompts: Write instructions matching your teaching style
  • Translations: Use orthography preferred by your community

Troubleshooting & Support

Common Issues & Solutions

Issue: "Can't publish lesson"

Solutions:

  1. Verify unit is published (lesson can't be visible if unit is draft)
  2. Check lesson has at least one question
  3. Ensure questions are complete (all fields filled)
  4. Try refreshing the page

Issue: "Students not seeing feedback"

Solutions:

  1. Verify feedback was saved (check submission again)
  2. Ask student to refresh their app
  3. Check student has correct submission ID (not an older attempt)

Issue: "Dashboard not loading"

Solutions:

  1. Refresh the page (F5)
  2. Check internet connection
  3. Clear browser cache
  4. Try different browser
  5. Contact admin if persistent

Issue: "Time zone causing wrong dates"

Solutions:

  1. Check the organization time zone setting in Organization Details.
  2. Verify your computer's date/time is correct
  3. Remember: Dates use the organization time zone, not always your local time zone

Getting Help

Steps:

  1. Check This Documentation: Search for your issue
  2. Review Manual Test Guides: See manual_system_tests.md for detailed workflows
  3. File an In-App Bug Report: If the bug-report button is enabled, select the red bug icon or press Ctrl+B / Cmd+B
  4. Annotate the Screenshot: Draw on the captured screenshot and describe what happened
  5. Contact Admin: Reach out to your organization admin
  6. Platform Support: If you're an admin, contact platform administrator

The in-app bug report includes the current page URL and a screenshot you approve through the browser screen-share prompt. The description is required before submitting.


Large Classes and Browser Tips

Best Practices for Large Classes

If You Have 50+ Students:

  • Use pagination (don't load all students at once)
  • Delete old classes periodically to keep active views focused
  • Keep units organized (max 10-15 per class)
  • Limit lessons per unit (max 15-20)

If You Have 10+ Classes:

  • Use class search/filter to find quickly
  • Delete completed classes after semester when students should no longer access them
  • Use consistent naming conventions
  • Consider class codes (e.g., "OJB-101-Fall24")

Browser Performance

Recommended:

  • Chrome, Firefox, Safari, Edge (latest versions)
  • At least 4GB RAM
  • Stable internet connection (DSL or better)

Tips:

  • Close unused tabs
  • Clear cache if experiencing slowness
  • Disable unnecessary browser extensions
  • Use Incognito/Private mode for testing

Accessibility Features

Keyboard Navigation

Supported Shortcuts:

  • Tab: Navigate between form fields
  • Enter: Submit forms, confirm dialogs
  • Esc: Close dialogs
  • Arrow Keys: Navigate calendar, dropdowns

Screen Reader Compatibility

ARIA Labels:

  • All buttons have descriptive labels
  • Form fields have proper associations
  • Error messages are announced
  • Loading states are communicated

Best for: NVDA, JAWS, VoiceOver users


Tips from Experienced Instructors

Content Creation Workflow

  1. Plan First: Outline full curriculum before creating lessons
  2. Start Small: Create 1-2 units, test with students, iterate
  3. Reuse Translations: Build dictionary early, questions become faster
  4. Import from Catalogue: Don't reinvent the wheel
  5. Iterate: Perfect lessons don't exist, improve as you teach

Student Engagement Strategies

  1. Celebrate Streaks: Recognize students publicly for consistency
  2. Quick Feedback: Even "Great job!" is better than silence
  3. Audio Feedback: Game-changer for pronunciation learning
  4. Monitor Dashboard: Check activity feed daily for engagement
  5. Encourage Daily Review: Reinforces learning dramatically

Time Management

  1. Batch Tasks: Review all submissions for one lesson at once
  2. Schedule Content: Use calendar to pace yourself
  3. Publish Gradually: Don't release all units on day 1
  4. Delegate: If you have co-instructors, divide units between you
  5. Use Unscheduled List: Quick way to see what needs attention

Frequently Asked Questions

Q: Can I have co-instructors collaborate on the same class?

A: Yes! When creating a class, select multiple instructors. All can view/edit content and students.

Q: What happens if I delete a question that students already answered?

A: The submission history remains intact with the question content snapshot. Students' answers are preserved.

Q: Can I duplicate a lesson to another unit?

A: Not directly. Use System Catalogue workflow: "Import" creates a copy you can place in any unit.

Q: How do I migrate students between classes?

A: Currently manual: Deactivate in old class (preserves data), add to new class with same name/access code.

Q: What's the maximum file size for audio/images?

A: Audio: 10MB, Images: 5MB (configurable by platform admin).

Q: Can students see their own progress/scores?

A: Yes, in the mobile app they can view submission history and scores.

Summary

Focus on the habits that save time and help students: use the System Catalogue, build your translation library early, schedule lessons with the calendar, review the dashboard often, give feedback, and encourage Daily Review.