Skip to main content

Emoji Reference Guide for AVP Documentation

This reference guide explains the emoji conventions used throughout the Asset Valuer Pro technical documentation. These conventions are designed to improve readability and provide visual cues to help navigate the documentation more efficiently.

Section Headers​

EmojiMeaningUsage
📋Process workflows and proceduresUsed for sections describing step-by-step processes and operational workflows
đŸ—ī¸Architecture and structure informationUsed for sections describing system architecture, components structure, and organization
🔧Technical components and implementationsUsed for sections detailing specific technical implementations and components
📊Data models and schemasUsed for sections describing data structures, models, and database schemas
📝Business context and requirementsUsed for sections explaining business rules, requirements, and domain context

API Endpoints​

EmojiMeaningUsage
🔍GET operationsUsed for API endpoints that retrieve data
âœī¸POST operationsUsed for API endpoints that create new resources
🔄PUT/PATCH operationsUsed for API endpoints that update existing resources
đŸ—‘ī¸DELETE operationsUsed for API endpoints that remove resources
🔒Security-related endpointsUsed for authentication, authorization, and security features

Information Types​

EmojiMeaningUsage
💡Tips and recommendationsUsed for helpful suggestions and best practices
â„šī¸Important information or notesUsed for additional information and clarifications
âš ī¸Warnings and cautionsUsed for potential issues or areas requiring special attention
✅Validation and verificationUsed for sections about validation processes and data integrity
⚡Performance considerationsUsed for performance-related notes and optimizations

Data and Relationships​

EmojiMeaningUsage
🔑Key fields and identifiersUsed for primary keys and unique identifiers
🔗Relationships and referencesUsed for entity relationships and foreign key references
🧮Calculation and algorithmsUsed for mathematical operations and algorithmic processes
📱Mobile application componentsUsed for iOS app-specific functionality
🌐Web and frontend componentsUsed for web UI and frontend functionality

How to Use Emojis in Documentation​

  1. Section Headers: Place the appropriate emoji at the beginning of section headers

    ## đŸ—ī¸ Architecture Overview
  2. Information Notes: Use emojis for callout information

    💡 **Tip:** Use pagination for large datasets to improve performance.
  3. API Endpoints: Mark HTTP methods with the appropriate emoji

    #### 🔍 Get User By ID
  4. Entity Relationships: Use relationship emojis when describing connections

    - 🔗 **Related to**: User (many-to-one)

Consistency Guidelines​

  1. Use emojis sparingly and purposefully - only where they add value
  2. Place emojis at the beginning of headers or key points, not in the middle of text
  3. Maintain consistency across all documentation
  4. Limit to 1-2 emojis per section to avoid visual clutter