Tips for Amazon Writers

Amazon Writing Guidelines in YAML for LLM legibility

writing_guidelines:
  version: "2024.1"
  source: "Write Like an Amazonian"
  last_updated: "2018-11"
  
  core_principles:
    - name: "Direct Communication"
      rules:
        sentence_structure:
          max_words: 30
          response_types: ["Yes", "No", "Number", "I don't know (with follow-up)"]
        word_replacements:
          - replace: "due to the fact that"
            with: "because"
          - replace: "totally lack the ability to"
            with: "could not"
        
    - name: "Data-Driven Writing"
      rules:
        metrics:
          - replace: "subjective statements"
            with: "quantifiable metrics"
          examples:
            - before: "performance is much faster"
              after: "reduced TP90 latency from 10ms to 1ms"
            - before: "nearly all customers"
              after: "87% of Prime members"
            
    - name: "Technical Clarity"
      rules:
        acronyms:
          format: "{full_term} ({acronym})"
          example: "Non-Disclosure Agreement (NDA)"
        prohibited_phrases:
          - "would help the solution"
          - "might bring clarity"
          - "should result in benefits"
          - "significantly better"
          - "arguably the best"

  validation:
    required_elements:
      - quantifiable_metrics
      - specific_data_points
      - defined_acronyms
    prohibited_elements:
      - weasel_words
      - subjective_adjectives
      - undefined_acronyms