# Grafana Brand Voice Guidelines

This document outlines the core principles and characteristics of Grafana's communication style, tone, and patterns to ensure consistency across all brand touchpoints.

## Communication Style

### Overall Tone and Personality
Grafana's tone is **authoritative, empowering, and pragmatic**, while remaining **approachable and forward-looking**. We speak with confidence about our solutions and the future of observability, always focusing on how we empower users to achieve more. There's a subtle undertone of innovation and a commitment to openness. We are professional but avoid being overly formal or academic, occasionally injecting a touch of confident playfulness.

### Key Stylistic Elements and Patterns
*   **Concise and Impactful:** We use short, punchy sentences and phrases to deliver key messages effectively (e.g., "See clearly. Act faster. Spend smarter.").
*   **Benefit-Oriented Language:** We consistently highlight the value and outcomes for the user, rather than just listing features.
*   **Problem-Solution Framing:** Content often identifies a common challenge (e.g., "Too many tools and data silos?") before presenting Grafana's solution.
*   **Strong Verbs and Active Voice:** We use action-oriented language to convey dynamism and efficiency (e.g., "Accelerate," "Resolve," "Cut costs," "Unify").
*   **Emphasis on "Openness":** We frequently highlight our commitment to open standards, open source, and avoiding vendor lock-in.
*   **Clear Categorization and Lists:** Information is often presented in bullet points or numbered lists for readability and quick comprehension.

### Vocabulary Preferences and Word Choices
*   **Technical Precision:** We use industry-standard terms like "observability," "telemetry," "AI," "Kubernetes," "OpenTelemetry," "full-stack," "logs," "metrics," and "traces" accurately.
*   **Empowering & Efficiency-Focused:** Words like "accelerate," "resolve," "optimize," "simplify," "maximize," "insight," "clarity," "empower," "streamline," "faster," "smarter," "lower."
*   **Innovation & Future-Oriented:** "AI-powered," "next evolution," "modern operations," "always evolving."
*   **Core Values:** "Open," "unified," "flexible," "predictable," "reliable," "secure."

## Content Patterns

### Common Themes and Topics
*   The transformative role of AI in observability.
*   Cost optimization and efficiency in telemetry management.
*   Breaking down data silos and achieving full-stack observability.
*   Accelerating incident resolution and improving operational workflows.
*   The benefits of open standards, open source, and avoiding vendor lock-in.
*   Scalability, reliability, and enterprise-grade security.
*   Empowering engineering teams with powerful, accessible tools.

### Structural Approaches to Content
*   **Benefit-First Headlines:** Titles and headings clearly state the primary advantage or outcome.
*   **Introductory Hook:** Often starts with a compelling statement or question that resonates with audience pain points.
*   **Modular Sections:** Content is broken into logical, digestible sections, often with subheadings.
*   **Feature-Benefit Integration:** Features are almost always immediately followed by their corresponding benefits.
*   **Visual Scannability:** Heavy use of bullet points, bolding, and short paragraphs to enhance readability.

### Call-to-Action Styles and Patterns
*   **Direct and Clear:** CTAs are straightforward and unambiguous (e.g., "Get started free," "Learn more," "Create free account," "Subscribe").
*   **Benefit-Driven:** Some CTAs subtly reinforce a benefit (e.g., "Donut take our word for it. Try Grafana Cloud today.").
*   **Embedded and Prominent:** CTAs appear both within the body copy as links and as distinct, eye-catching buttons.
*   **Action-Oriented Verbs:** "Get," "Learn," "Create," "Compare," "Try," "Sign up."

## Audience Interaction

### How the Brand Addresses Its Audience
We address our audience directly using "you" and "your," fostering a sense of partnership and direct value (e.g., "monitors *your* AI," "Ask *your* questions," "Unify *your* stack, *your* way"). We speak to technical professionals as peers, assuming a baseline understanding of technical concepts but always striving for clarity and accessibility.

### Level of Formality and Relationship Style
The relationship is one of a **trusted expert and enabler**. We are professional and knowledgeable, providing solutions and guidance, but also approachable and supportive. We aim to be seen as a partner in solving complex technical challenges, making advanced observability accessible.

### Engagement and Conversation Patterns
*   **Anticipating Needs:** We address common pain points and questions proactively.
*   **Empowering Language:** We use phrases that encourage action and highlight user agency.
*   **Direct Questions (occasional):** Used to prompt thought or guide the user to a solution (e.g., "Still have questions?").
*   **Invitations:** We invite users to explore, try, and learn more.

## Guidelines & Examples

### Do's and Don'ts for Brand Communication
*   **DO:**
    *   Focus on tangible benefits and solutions for the user.
    *   Use clear, concise, and actionable language.
    *   Highlight Grafana's commitment to openness, flexibility, and avoiding lock-in.
    *   Empower the user with tools and insights.
    *   Break down complex technical concepts into understandable parts, often using lists.
    *   Maintain a confident, authoritative, yet approachable tone.
*   **DON'T:**
    *   Use overly academic or abstract language.
    *   Be vague or ambiguous about features or benefits.
    *   Sound overly corporate, stiff, or overly salesy.
    *   Make unsubstantiated claims.
    *   Use passive voice when active voice is clearer.

### Example Phrases and Expressions That Are "On-Brand"
*   "AI that monitors your AI, faster log search, lower telemetry costs, and more."
*   "See clearly. Act faster. Spend smarter."
*   "Plug in, not lock in."
*   "One platform for both."
*   "Let AI do the heavy lifting."
*   "Break the link between data volume and your observability bill."
*   "Full-stack observability. One view. Infinite clarity."
*   "Accelerate engineering with AI-powered observability."
*   "Unify your stack, your way."

### Content Types and Formats the Brand Uses
*   Blog posts (product announcements, technical deep dives, thought leadership)
*   Marketing landing pages (benefit-driven overviews)
*   Product and solution descriptions (detailed features, use cases, benefits)
*   Documentation and guides
*   Newsletters
*   Event announcements and summaries
*   Customer success stories
*   Comparison pages