SwiftReporter

Using Comments in Inspections

Using Comments in Inspections

SwiftReporter using comments in inspections

Comments are most powerful when used effectively during inspections. This guide explains how to search, filter, and apply comments to observations, creating efficient workflows that produce consistent, high-quality reports.

Finding Comments During Inspections

Accessing the Comment Search

When creating or editing an observation, you can access your comment library:

  1. Open Observation: Navigate to a new or existing observation
  2. Find Search Button: Look for the magnifying glass icon or "Search Comments" button
  3. Open Comment Library: Tap to open the searchable comment library
  4. Browse or Search: Use search or filters to find relevant comments

Basic Search Functionality

Keyword search: Type words or short fragments related to your observation.

  • SwiftReporter splits your query into separate terms. Every term must appear somewhere in the comment's title, description, recommendation, category, or subcategory. Terms do not need to be next to each other or in order.
  • Example: ext rail low can match a deck-railing comment filed under Exterior even though those words are spread across the title and section names.
  • When you enter search text, SwiftReporter searches your full accessible comment library for matches, then shows results with infinite scroll. Matches are not limited to the first page of the browse list.
  • On the Comments page in the web app, enter at least 3 characters before search runs. If you type fewer than 3 characters, the field shows Enter at least 3 characters to search.
  • In the mobile app comment list and in inspection comment pickers (web and mobile), there is no minimum character count — search runs as soon as you type.

Example Searches:

  • GFCI — finds GFCI-related comments
  • water heater — finds water heater observations
  • electrical panel — finds panel-related defects
  • ext rail — finds comments whose text or category names include both fragments

Advanced Search Features

Similarity search (embeddings)

In addition to keyword matching, SwiftReporter indexes saved comments for meaning-based similarity search. This helps surface near-matches when your wording differs from the saved comment text.

How it works:

  • Indexing runs in the background when you save or edit a comment's title, description, or recommendation.
  • Newly saved or edited comments can take a few seconds to appear in similarity-based results. Keyword search reflects saved text once the library has loaded.
  • Similarity search complements keyword search; it does not replace partial keyword matching for short typed fragments.

Contextual Search

The system considers your current inspection context:

  • Current Category: Prioritizes comments from the same category
  • Current Subcategory: Shows relevant subcategory comments first
  • Template: Filters comments associated with your current template
  • Recent Usage: Surfaces recently used comments for similar situations

Filtering Comments

Filter Options

Template Filter: Show only comments from specific templates

  • Useful when working with multiple template types
  • Ensures comments are relevant to current inspection type
  • Helps maintain consistency with template requirements

Category Filter: Narrow results to specific categories

  • Focus on specific inspection areas
  • Reduce cognitive load by showing only relevant comments
  • Organize workflow by category

Subcategory Filter: Further refine to specific components

  • Pinpoint exact component-related comments
  • Increase precision of search results
  • Match specific observation context

Comment Type Filter: Choose between defect and note comments

  • Defect Comments: For issues requiring action
  • Note Comments: For informational content
  • All Types: Show both defect and note comments

Using Filters Effectively

Sequential Filtering:

  1. Start with Template filter for relevance
  2. Add Category filter for focus
  3. Include Subcategory filter for precision
  4. Apply Type filter for specific needs

Common Filter Combinations:

  • Template + Category: Find all electrical comments for residential inspections
  • Category + Type: Find all defect comments for plumbing issues
  • Subcategory + Recent: Find recently used comments for specific components

Applying Comments to Observations

Direct Application

  1. Select Comment: Choose the comment you want to apply
  2. Apply to Observation: The system automatically fills observation fields:
    • Title from comment title
    • Description from comment description
    • Category and subcategory from comment metadata
    • For defects: Recommendation and severity are included
  3. Verify Application: Review the applied content for accuracy
  4. Customize if Needed: Modify fields for specific situation

Customizing Applied Comments

Why Customize:

  • Specific location details for this inspection
  • Unique circumstances not covered in the comment
  • Additional context for the client
  • Severity adjustments based on actual conditions

Best Practices for Customization:

  • Modify location field for specific positioning
  • Adjust severity based on actual conditions
  • Add specific details in description
  • Update recommendation for unique circumstances

Partial Application

You can use comments as starting points:

  • Apply the comment structure and modify content
  • Use comment recommendations as inspiration
  • Copy specific language while adding unique details
  • Build upon existing comments for complex situations

Creating Comments from Observations

Save to Comment Library

When you create a detailed observation that could be reused:

  1. Complete Observation: Fill in all relevant fields
  2. Save to Library: Use the "Save to Comment Library" option
  3. Review Content: The system creates a comment from your observation
  4. Edit for Reusability: Remove location-specific details
  5. Save Comment: Add to your personal library

Making Comments Reusable

Remove Location Specifics:

  • Change "kitchen GFCI outlet" to "GFCI outlet"
  • Remove specific addresses or room numbers
  • Use generic location references

Generalize Descriptions:

  • Focus on the defect type rather than specific instance
  • Use language that applies to similar situations
  • Avoid inspection-specific details

Optimize for Search:

  • Include relevant keywords in title and description
  • Use standard industry terminology
  • Consider how you'll search for this comment in the future

Workflow Integration

Efficient Inspection Workflow

Pre-Inspection Setup:

  1. Review template-specific comments
  2. Identify common issues for the property type
  3. Prepare frequently used comments
  4. Set up filters for quick access

During Inspection:

  1. Create observations as you find issues
  2. Search comments for similar situations
  3. Apply and customize comments as needed
  4. Save new observations to library when valuable

Post-Inspection:

  1. Review applied comments for accuracy
  2. Update comment library with improvements
  3. Note which comments were most useful
  4. Identify gaps in comment coverage

Mobile Optimization

Quick Access Features:

  • Recent comments appear first
  • Frequently used comments are prioritized
  • Search suggestions based on context
  • Simplified interface for mobile use

Offline Capability:

  • Recently used comments available offline
  • Local cache for common comments
  • Sync updates when connection restored
  • Seamless online/offline transition

Advanced Usage Techniques

Comment Combinations

Multi-Comment Observations:

  • Use one comment as the base
  • Add elements from other comments
  • Combine defect and note comments
  • Create comprehensive observations

Sequential Application:

  • Apply structural comment first
  • Add safety-related note comment
  • Include regulatory requirement comment
  • Build complete observation picture

Template-Specific Strategies

Residential Inspections:

  • Focus on common residential defects
  • Use homeowner-friendly language
  • Include maintenance recommendations
  • Emphasize safety concerns

Commercial Inspections:

  • Use code-compliant language
  • Include regulatory references
  • Focus on business impact
  • Emphasize compliance requirements

Batch Processing

Similar Observations:

  • Apply same comment to multiple observations
  • Use filters to find related comments
  • Create observation templates
  • Streamline repetitive tasks

Category-Based Processing:

  • Complete all electrical observations together
  • Use category filters for focus
  • Apply consistent language across category
  • Maintain professional consistency

Quality Assurance During Inspections

Verification Process

Before Applying Comments:

  1. Verify comment accuracy for current situation
  2. Check that severity level is appropriate
  3. Ensure recommendations are feasible
  4. Confirm category and subcategory match

After Applying Comments:

  1. Review all applied content
  2. Customize for specific circumstances
  3. Verify technical accuracy
  4. Ensure professional presentation

Common Mistakes to Avoid

Inappropriate Application:

  • Using comments that don't match the actual situation
  • Applying comments without reading the content
  • Ignoring severity level appropriateness
  • Failing to customize for specific circumstances

Search Limitations:

  • Searching with terms that are too generic
  • Not using filters effectively
  • On web Comments, typing fewer than 3 characters (search does not run until you reach 3)
  • Failing to try alternative search terms

Troubleshooting Search Issues

Comment Not Found

Possible Issues:

  • Comment is in wrong category
  • Search terms don't match content
  • Filters are too restrictive
  • Comment was recently deleted

Solutions:

  • Broaden search terms or try shorter fragments that still match category names (for example ext for Exterior)
  • Remove or adjust filters
  • Try alternative keywords or out-of-order fragments like rail ext
  • Wait a few seconds after saving a new comment if you are relying on similarity-based results

Irrelevant Results

Causes:

  • Search terms are too broad
  • Filters not applied correctly
  • Comment categorization issues
  • AI learning from incorrect usage

Solutions:

  • Use more specific search terms
  • Apply appropriate filters
  • Review comment categorization
  • Provide feedback on search results

Slow Search Performance

Causes:

  • Large comment library
  • Complex search queries
  • Network connectivity issues
  • System performance problems

Solutions:

  • Use filters to narrow search scope
  • Simplify search terms
  • Check network connection
  • Clear app cache if needed

Integration with Other Features

Photo Integration

Comments with Photos:

  • Comments provide context for photos
  • Photos illustrate comment content
  • Combined approach improves clarity
  • Enhanced report presentation

Photo-Based Search:

  • Use comments to describe photo content
  • Search for comments related to visual defects
  • Apply comments that reference photos
  • Create comprehensive visual documentation

Audio Integration

Audio Notes with Comments:

  • Record audio to supplement applied comments
  • Use comments as audio transcription starting points
  • Combine comment text with audio clarification
  • Create multi-media observations

Report Integration

Comment Formatting in Reports:

  • Applied comments appear professionally formatted
  • Consistent presentation across all reports
  • Proper categorization and organization
  • Integration with photos and other media

Tips for Maximum Efficiency

Search Optimization

  1. Use specific keyword fragments: Be precise; every term you type must match somewhere in the comment or its section names
  2. Use longer phrases for similarity: Descriptive queries help surface near-matches with different wording
  3. Apply filters: Use filters to narrow results quickly
  4. Try variations: Reorder or abbreviate terms (for example ext rail low)

Library Management

  1. Regular Updates: Keep comments current and accurate
  2. Consistent Naming: Use predictable naming conventions
  3. Quality Focus: Maintain high standards for comment content
  4. Usage Review: Regularly review which comments are most valuable

Workflow Efficiency

  1. Prepare in Advance: Review relevant comments before inspections
  2. Use Templates: Develop comment application templates
  3. Practice Search: Become proficient with search functionality
  4. Customize Systematically: Develop consistent customization approaches

💡 Tip: The most efficient inspectors develop a systematic approach to comment usage, combining effective search techniques with consistent application and customization processes.

Best Practices Summary

Search Strategy

  • Start with specific keyword fragments; add more terms to narrow results
  • Use similarity-friendly phrasing for longer, descriptive queries
  • Apply filters systematically
  • Try alternative search approaches

Application Process

  • Review comment content before applying
  • Customize for specific circumstances
  • Verify technical accuracy
  • Maintain professional standards

Quality Assurance

  • Double-check all applied content
  • Ensure recommendations are appropriate
  • Verify category and subcategory accuracy
  • Maintain consistency across observations

Library Growth

  • Save valuable new observations to library
  • Remove location-specific details
  • Optimize for future searchability
  • Maintain organization standards

Using comments effectively during inspections requires practice and systematic approach. Focus on building efficient search habits, maintaining quality standards, and continuously improving your comment library based on real-world usage. This investment in comment system proficiency will significantly improve your inspection efficiency and report quality over time.

Related