Quick Start

Let's get you logged into define.wtf and add your first acronym. You'll be up and running in just a few minutes.

Step 1: Log In via SSO

Your admin has already set up your organization's workspace. Navigate to your workspace URL (something like yourteam.define.wtf) or use the link your admin provided.

On the login page, click "Sign in with SSO" (or the name of your identity provider, like Auth0, Okta, or Azure AD).

You'll be prompted to authenticate with your organization's identity provider. Once authenticated, you'll land on your dashboard.

Step 2: Explore the Dashboard

The dashboard gives you an at-a-glance view of your workspace:

• Total Acronyms — How many terms are in your dictionary
• Recent Activity — Latest additions and edits by your team
• Top Contributors — Team members earning the most points
• Most Viewed Acronyms — Terms your team is looking up most frequently
• Activity Timeline — A visual breakdown of contributions over time

This is a great place to get a sense of what your team is already documenting.

Step 3: Search for an Acronym

Let's search for a term you're curious about. Press Cmd+K (on Mac) or Ctrl+K (on Windows/Linux) to open the command palette.

Start typing an acronym or keyword. As you type:

• Search results appear instantly, powered by full-text search
• Results are sorted by relevance and popularity
• Hit Enter to view the full details of an acronym

For example, search for an acronym you know your team uses frequently — maybe "OKR", "SSO", or something specific to your company.

Step 4: Browse by Category

Want to explore without searching? Click Browse in the main navigation.

The browse page shows all acronyms in your dictionary, organized by category. You can:

• Filter by category — Click on a category to see only terms in that area
• Sort by name, date, or popularity — Choose how you view the list
• Search within results — Narrow down to specific terms

This is a great way to discover new terminology and get a feel for how your team's dictionary is organized.

Step 5: Add Your First Acronym

Time to contribute. Look for the floating action button (the "+" icon) in the bottom-right corner of the app on any page, or use the command palette to select "Add new acronym".

A form will open where you can:

1. Enter the acronym — The term itself (e.g., "SCIM")
2. Provide a definition — Clear explanation of what it means
3. Add context (optional) — When or where it's used
4. Choose categories — Assign to one or more categories to keep things organized
5. Add related terms (optional) — Link to other acronyms this term relates to

Fill out at least the acronym and definition, then click Save.

Step 6: Explore Collections

Your admin may have created Collections — curated lists of acronyms organized by team, project, or domain.

Click Collections in the main navigation to see available collections. Collections are a great way to:

• Find acronyms relevant to a specific project or team
• Get onboarded on terminology for a particular domain
• See how different areas of your organization define related terms

Step 7: View Your Profile

Click your profile icon in the top-right corner to view your user profile.

Here you'll see:

• Your contributions — All acronyms you've created or edited
• Your points — Points earned for contributions and upvotes
• Your rank — How you stack up against other contributors in your organization

Points are earned by:

• Adding a new acronym (points awarded immediately)
• Receiving upvotes on your definitions (points accumulate as your team votes)

What's Next?

You're now ready to use define.wtf! Here are some suggestions for what to explore next:

• Browse more acronyms — Spend a few minutes clicking around the browse page to get familiar with your team's terminology
• Search for domain-specific terms — Look up acronyms relevant to your role or team
• Add more acronyms — If you encounter terms your team doesn't have documented yet, add them
• Upvote definitions you find useful — Help surface the most valuable definitions
• Check out Slack integration — If enabled, try using /define ACRONYM directly in Slack

Getting Help

If you run into issues or have questions:

• Hover over any icon or label — Tooltips provide quick explanations
• Contact your admin — They can help with permissions, workspace configuration, or other questions
• Check the User Guide — More detailed documentation on specific features

Ready to dive deeper? Check out the User Guide for detailed walkthroughs of each feature.