thrillwiki_django_no_react/shared/docs/moderation_guide.md

ThrillWiki Moderation Guide

Overview

This guide covers the moderation systems in ThrillWiki, including:

• Content edit submissions
• Photo submissions
• User reviews
• Report handling
• Moderation best practices

Moderation Dashboard

Access the moderation dashboard at /moderation/ to view:

• Pending edit submissions
• Photo submissions awaiting review
• Reported content
• Moderation statistics

Content Edit Moderation

Edit Submission Types

1. Edit Existing

   • Changes to existing parks, rides, or other content
   • Shows diff of proposed changes
   • Requires source verification

2. Create New

   • New park, ride, or content submissions
   • Requires complete information
   • Needs source verification

Review Process

1. Initial Assessment

   • Check submission completeness
   • Verify sources
   • Review user history

2. Status Options

   STATUS_CHOICES = [
       ('NEW', 'New'),
       ('APPROVED', 'Approved'),
       ('REJECTED', 'Rejected'),
       ('ESCALATED', 'Escalated'),
   ]
   

3. Actions

   • Approve: Apply changes after verification
   • Reject: Provide clear reason
   • Escalate: For complex cases needing admin review

Approval Guidelines

• Verify information accuracy
• Check reliable sources
• Ensure formatting consistency
• Review for completeness

Rejection Guidelines

• Provide clear explanation
• Reference guidelines
• Suggest improvements
• Be constructive

Photo Moderation

Submission Types

• Park photos
• Ride photos
• Attraction photos
• Historical photos

Review Process

1. Initial Check

   • Image quality
   • Appropriate content
   • Copyright concerns
   • Metadata accuracy

2. Status Options

   STATUS_CHOICES = [
       ('NEW', 'New'),
       ('APPROVED', 'Approved'),
       ('REJECTED', 'Rejected'),
       ('AUTO_APPROVED', 'Auto Approved'),
   ]
   

3. Actions

   • Approve: Add to main gallery
   • Reject: Explain issues
   • Auto-approve: For trusted users

Photo Guidelines

• Minimum resolution requirements
• No watermarks
• Clear and focused
• Appropriate content
• Proper attribution

Review Moderation

Review Components

• Rating (1-10)
• Written content
• Visit date
• Optional photos

Moderation Criteria

1. Content Standards

   • Constructive feedback
   • No personal attacks
   • Family-friendly language
   • Factual accuracy

2. Rating Consistency

   • Check against written content
   • Compare with average ratings
   • Look for rating abuse

3. Photo Guidelines

   • Relevant to review
   • Appropriate content
   • Quality standards

Report Handling

1. Review Reports

   • Assess reported content
   • Check reporter history
   • Verify claims

2. Actions

   • Remove inappropriate content
   • Edit/update if needed
   • Notify users
   • Document actions

Best Practices

General Guidelines

1. Consistency

   • Follow established guidelines
   • Apply rules uniformly
   • Document decisions

2. Communication

   • Clear explanations
   • Professional tone
   • Constructive feedback

3. Escalation

   • Know when to escalate
   • Document complex cases
   • Seek admin input

Quality Control

1. Content Standards

   • Accuracy
   • Completeness
   • Formatting
   • Source verification

2. User Management

   • Track user history
   • Identify trusted contributors
   • Handle problem users

3. Documentation

   • Record decisions
   • Note special cases
   • Track patterns

Moderation Tools

Edit Submission Tools

def approve(self, user):
    """Approve and apply changes"""
    # Validates and applies changes
    # Updates status
    # Records moderator action

def reject(self, user):
    """Reject submission"""
    # Updates status
    # Records moderator action
    # Notifies user

def escalate(self, user):
    """Escalate to admin"""
    # Marks for admin review
    # Records moderator action

Photo Submission Tools

def approve(self, moderator, notes=''):
    """Approve photo"""
    # Moves to main gallery
    # Updates status
    # Records approval

def reject(self, moderator, notes):
    """Reject photo"""
    # Updates status
    # Records rejection reason
    # Notifies user

Special Cases

Content Disputes

1. Handling Conflicts

   • Review all perspectives
   • Check reliable sources
   • Document decisions
   • Consider escalation

2. Resolution Process

   • Gather evidence
   • Consult experts if needed
   • Make documented decision
   • Communicate clearly

Emergency Situations

1. Immediate Action Needed

   • Inappropriate content
   • Copyright violations
   • Personal information
   • Harmful content

2. Response Protocol

   • Remove content immediately
   • Document action taken
   • Notify administrators
   • Follow up as needed

Moderation Workflow

1. Daily Tasks

   • Review new submissions
   • Check reported content
   • Handle escalations
   • Update documentation

2. Weekly Tasks

   • Review moderation patterns
   • Check for recurring issues
   • Update guidelines if needed
   • Team communication

3. Monthly Tasks

   • Review statistics
   • Assess guidelines
   • Plan improvements
   • Team training

Resources

Reference Materials

• Content guidelines
• Photo standards
• Review policies
• Escalation procedures

Support Channels

• Admin contact information
• Team communication
• Emergency procedures
• Legal resources

Training and Development

1. New Moderator Training

   • Platform overview
   • Tools introduction
   • Guidelines review
   • Supervised practice

2. Ongoing Development

   • Regular updates
   • Case studies
   • Best practices
   • Team feedback

Conclusion

Effective moderation is crucial for maintaining ThrillWiki's quality and community. Follow these guidelines consistently while using good judgment for special cases. Document decisions and seek help when needed.