Style Guides and Examples

    Curriculum Settings
    Updated Jan 22, 2026
    2 min read

    Control how the AI writes by providing style guides and example comments it can learn from.

    What Are Style Guides?

    Style guides control how comments are written. They define:

    • Tone – Formal, warm, encouraging
    • Structure – Paragraph length, sentence complexity
    • Language – Words to use or avoid
    • Format – How to begin and end comments

    Accessing Style Guides

    Navigate to Settings > Style Guide for your year level.

    Writing Effective Style Guides

    Be Specific

    ❌ "Write nicely"

    ✅ "Use encouraging language. Avoid negative phrasing. Start each comment with the student's name."

    Include Examples

    ❌ "Make it sound professional"

    ✅ "Use phrases like 'has demonstrated', 'consistently shows', 'is developing'. Avoid 'needs to work on' – instead use 'is building skills in'."

    Set Boundaries

    • Maximum/minimum sentence length
    • Paragraph structure preferences
    • Required elements (e.g., always mention next steps)

    Example Comments

    The Examples section lets you provide sample comments the system learns from.

    Adding Examples

    1. Navigate to Settings > Examples
    2. Click "Add Example"
    3. Paste a high-quality report comment
    4. Select the year level
    5. Save

    What Makes a Good Example?

    • Written by an experienced teacher
    • Follows your school's style
    • Demonstrates the tone you want
    • Includes curriculum-appropriate language

    How Many Examples?

    3-5 quality examples per year level is ideal. More examples give the AI more patterns to learn from.

    How Style Guides Affect Generation

    When you generate a comment:

    1. AI reads your style guide
    2. AI references your examples
    3. AI generates content matching your preferences
    4. Result feels consistent with your school's voice

    Tips for Best Results

    1. Review generated comments – Refine style guide based on what you see
    2. Update seasonally – Adjust language for different reporting periods
    3. Share with colleagues – Ensure consistency across year levels
    4. Test changes – Generate sample comments after updating

    Resetting to Defaults

    If your customisations aren't working well, reset to the template defaults and start fresh.

    Next Steps

    Tags:
    style guide
    examples
    AI
    writing
    tone

    Was this article helpful?