User Guide

Welcome to define.wtf — your team's collaborative acronym dictionary. Whether you're onboarding to a new organization, looking up unfamiliar terms, or contributing knowledge to help your teammates, this guide will walk you through everything you need to know.

What is define.wtf?

Define.wtf is a multi-tenant, collaborative acronym dictionary built for teams. It helps everyone in your organization understand industry jargon, internal acronyms, and domain-specific terminology. Unlike static glossaries or wikis, define.wtf is:

• Collaborative: Anyone can add definitions, and the community votes on the most helpful ones
• Multi-tenant: Safely isolated per organization with enterprise authentication
• Discoverable: Powerful search with fuzzy matching and full-text indexing
• Gamified: Earn points and badges for your contributions
• Integrated: Slack integration for instant /define lookups right in chat

Who is this guide for?

This guide covers all features available to regular users. If you're an administrator managing settings, users, or bulk imports, see the Admin Guide instead. For API integrations, see Getting Started.

Quick Navigation

• Searching — Find acronyms and definitions using powerful search tools
• Browsing — Explore all acronyms in your organization's dictionary
• Adding Acronyms — Contribute new terms and definitions
• Definitions & Voting — Understand how definitions work and vote on quality
• Collections — Discover curated acronym collections
• Your Profile — View your contributions and gamification progress
• Keyboard Shortcuts — Speed up your workflow with shortcuts

Your First 5 Minutes

1. Log in using your organization's single sign-on
2. Try searching — Press Cmd+K (or Ctrl+K on Windows/Linux) and type an acronym
3. Browse the dictionary — Click the "Browse" link to see all acronyms in your org
4. Add your first acronym — Click the floating action button (bottom-right) to contribute
5. Vote on definitions — Upvote definitions you find helpful

Key Concepts

Acronyms vs. Definitions

An acronym is a term (e.g., "OKR", "API", "ROI"). A definition is an explanation of what that acronym means. Multiple definitions can exist for a single acronym, voted up or down by the community to surface the most useful ones.

Categories and Tags

Categories organize acronyms by department or function (e.g., "Sales", "Engineering", "Finance"). Tags add additional labels to definitions for granular filtering and discovery.

Primary Definition

Each acronym has a primary definition — the one users see first and in Slack lookups. Only editors and administrators can set this, but any user can vote to help surface the best definitions.

Collections

Collections are curated lists of related acronyms. Onboarding collections are automatically shown to new team members to help them ramp up quickly.

Gamification

Contribute definitions, votes, and acronyms to earn points and unlock badges. Your contributions are tracked on the organization leaderboard — friendly competition that keeps your dictionary rich and up-to-date.

Common Tasks

I need to understand an acronym

1. Open the command palette with Cmd+K
2. Type the acronym (e.g., "OKR")
3. Select the acronym from autocomplete results
4. Read the primary definition and vote on others if helpful

I want to add a new acronym

1. Click the floating action button (bottom-right, mobile-friendly)
2. Enter the acronym (auto-uppercased), title, and optional description
3. Choose a category and add tags
4. Click "Add Acronym" — profanity filters run automatically

I found a definition that's unclear or wrong

1. Navigate to the acronym page
2. Vote down on the unclear definition (clicking thumbs-down)
3. Optionally, add a new, better definition yourself

I want to see all acronyms in my department

1. Go to Browse
2. Click a category filter (e.g., "Engineering", "Marketing")
3. Browse the filtered list and use the sort dropdown to organize by date or popularity

Tips & Best Practices

• Use specific titles — Titles should be clear explanations, not just expansions of the acronym
• Leverage tags — Tag definitions with context (e.g., "financial", "strategic", "marketing-specific")
• Vote thoughtfully — Upvote definitions that are accurate and helpful; downvote those that are misleading
• Check before adding — Use search to see if an acronym already exists before creating a duplicate
• Mobile-friendly — The floating action button moves to the bottom-right on mobile; all features work on small screens

Troubleshooting

Can't find an acronym?

• Try a partial search with a wildcard prefix (e.g., *OKR*)
• Check if it's been soft-deleted or marked deprecated
• Search may have fuzzy suggestions ("Did you mean?") if you misspell

Profanity filter rejected my definition?

• Avoid profanity or explicit content
• If your legitimate term is flagged, contact your administrator

How do I see recent searches?

• Open the command palette — recent searches appear at the top before you start typing

Next Steps

Ready to dive deeper? Pick a guide section above to get started, or check out the Admin Guide if you're responsible for managing your organization's dictionary.