Navigating the App

define.wtf is organized into several key sections. This guide walks you through each one and explains what you can do in each area.

Main Navigation

At the top of every page, you'll find the main navigation bar with the following sections:

• Dashboard — Your workspace overview
• Browse — Explore the full dictionary
• Search — Full-text search with advanced filters
• Collections — Curated lists of acronyms
• Profile — Your personal stats and contributions
• Admin (if you have permissions) — Workspace settings and management

Dashboard

The Dashboard is your workspace's command center. It provides an overview of activity, contributions, and trends.

What You'll See

Workspace Stats

• Total number of acronyms in your dictionary
• Total number of definitions across all acronyms
• Number of active contributors this month
• Number of teams/categories set up

Recent Activity Feed

• Latest acronyms added by team members
• Recent edits and updates
• New definitions on existing acronyms
• Shows contributor name and timestamp

Top Contributors

• Team members ranked by points earned this month or all-time
• Hover over a contributor to see their total contributions
• Points come from adding acronyms, receiving upvotes, and other engagement

Most Viewed Acronyms

• Terms your team is looking up most frequently
• Shows view count and popularity trends
• Great insight into what terminology matters most

Activity Timeline

• Visual chart showing contribution trends over time
• Filter by week, month, or year
• Spot patterns in when your team is actively building your dictionary

Your Role in the Dashboard

If you have admin permissions, the dashboard includes additional management information like new user signups, pending moderation tasks, and system health. Non-admins see a curated view focused on contribution stats and trends.

Browse

The Browse section lets you explore your entire acronym dictionary in an organized, filterable view.

Browsing Options

View by Category

• Click a category name to filter the list
• See how many acronyms are in each category
• Categories are usually organized by department, domain, or project type

View by Collections

• Collections are hand-curated lists of related acronyms
• Browse collections to see acronyms grouped by theme or project
• Each collection has a description explaining its focus

Sort Options

• Alphabetical — A to Z by acronym name (default)
• Most Viewed — Terms your team looks up most
• Newest — Recently added acronyms
• Most Voted — Highest-rated definitions
• Most Commented — Acronyms with active discussion

Searching Within Browse

The browse page has its own search bar to filter results as you scroll. This is useful if:

• You're browsing a category but want to narrow down further
• You want to find a specific acronym within a filtered view
• You're exploring and want to jump to a related term

Viewing an Acronym

Click on any acronym to open its details page, which shows:

• All definitions for that acronym (ranked by upvotes)
• Category tags — what categories it belongs to
• Who created it and when
• Related acronyms — links to connected terms
• Vote buttons — upvote definitions you find most useful
• Comments (if enabled) — team discussion on the definition

Search

The Search section provides powerful, full-text search capabilities with autocomplete and typo tolerance.

How to Search

Quick Search (Command Palette)

• Press Cmd+K (Mac) or Ctrl+K (Windows/Linux) anywhere in the app
• Start typing an acronym or keyword
• Results appear instantly as you type
• Press Enter on a result to view it, or Escape to close

Full Search Page

• Click Search in the main navigation
• Enter a search query in the search bar
• View all results with detailed information
• Use filters to narrow results by category, date, or contributor

Search Features

Full-Text Search — Searches both acronym names and definitions. If you search for "authentication" you'll find acronyms like "SSO" and "OIDC" that mention authentication in their definitions.

Autocomplete Suggestions — As you type, you'll see suggestions for:

• Matching acronym names
• Related terms based on popularity
• Categories that match your query

Typo Tolerance — Misspell something? The search still finds what you're looking for.

Filter by Category — On the search results page, use the category filter to narrow results to a specific domain.

Filter by Date — Find acronyms added or updated within a specific timeframe.

Filter by Contributor — See all acronyms added by a specific team member.

Search Tips

• Be specific — Search for the acronym name (e.g., "OKR") rather than a description
• Try keywords — If you don't know the exact acronym, search for a keyword (e.g., "goals")
• Use the command palette — For quick searches, Cmd+K is faster than navigating to the search page
• Browse categories — If you're not sure what you're looking for, browsing by category is often faster than searching

Collections

Collections are curated lists of acronyms organized by theme, project, department, or topic.

What Are Collections?

Collections group related acronyms together. For example:

• "Onboarding 101" — Essential acronyms for new hires
• "Engineering Fundamentals" — Terms used by the engineering team
• "Sales Terminology" — Business and sales-specific acronyms
• "Q3 Product Launch" — Acronyms relevant to a specific project

Viewing Collections

Click Collections in the main navigation to see all available collections:

• Each collection shows a title, description, and acronym count
• Click a collection to open it and see all included acronyms
• Collections can be searched and filtered like the main browse page

Creating Collections

If you have permission to create collections, you can:

1. Click New Collection (visible to collection managers)
2. Give it a name and description
3. Select which acronyms to include
4. Save and share with your team

Collections are a great way to:

• Onboard new team members on domain-specific terminology
• Organize acronyms by project or initiative
• Create department-specific reference guides
• Highlight important or frequently-used terms

Profile

Your profile page shows your contributions and engagement with define.wtf.

What's on Your Profile

Contribution Stats

• Total acronyms you've created
• Total definitions you've authored
• Total edits you've made
• Total upvotes received

Points & Rank

• Your current point total
• Your ranking among all contributors
• Point breakdown (points earned this month, all-time, etc.)

Recent Contributions

• A timeline of acronyms and definitions you've created
• Shows dates and edit history
• Links to each acronym you can click to view or edit

Earned Badges (if enabled)

• Badges for milestones (e.g., "First Contribution", "100 Points", "Top Contributor")
• Visual representations of your engagement

Edit Your Profile

Click Edit Profile to update:

• Display Name — How your name appears on contributions
• Bio — A short description of your expertise (optional)
• Avatar — Your profile picture

View Other Profiles

Click on any contributor's name throughout the app to see their profile, including:

• Their contributions
• Their points and rank
• Acronyms they've created
• Their areas of expertise (based on their contributions)

Command Palette

The Command Palette is your fastest way to navigate and act in define.wtf.

Press Cmd+K (Mac) or Ctrl+K (Windows/Linux) anywhere to open it.

Available Commands

Search

• Start typing to search acronyms and definitions
• Results update as you type
• Navigate with arrow keys, press Enter to view

Add New Acronym

• Type "add" to see the "Add new acronym" command
• Click it (or press Enter after selecting it) to open the form
• Pre-filled with any text you had in the search field

Navigate Pages

• Type "dashboard", "browse", "search", "collections", "profile" to jump to those pages
• Type "admin" if you have admin permissions to access admin settings

Quick Actions

• Type "/" to see all available quick actions
• Actions vary based on your permissions

Command Palette Tips

• It's super fast — Cmd+K is quicker than navigating menus, especially on mobile
• It works everywhere — No matter what page you're on, Cmd+K works
• Keyboard-first — Use arrow keys to navigate, Enter to select
• Smart defaults — The first result is automatically selected so you can hit Enter immediately

Floating Action Button

In the bottom-right corner of most pages, you'll see a floating action button (FAB) — a button with a "+" icon.

Click this button to:

• Add a new acronym — Opens the acronym creation form
• Create a new collection (if you have permission) — Start a new curated list

On mobile, this button is essential — it's the primary way to add new content without using the command palette.

Admin Section

If you have admin permissions, an Admin link appears in the main navigation.

Admin Functions

Admins can:

• Manage Users — Add, remove, or adjust permissions for team members
• Configure Settings — Set up SSO, Slack integration, category colors, profanity filters
• Review Moderation — Approve or reject flagged content
• View Audit Logs — See a complete history of all changes
• Manage Collections — Create, edit, or delete collections
• Bulk Import/Export — Add many acronyms at once or export your dictionary
• Slack Settings — Connect or disconnect your Slack workspace
• Webhooks — Set up integrations to external systems

See the Admin Guide for detailed walkthroughs of each admin feature.

User Menu

Click the user icon in the top-right corner to access:

• View Profile — See your profile and stats
• Edit Profile — Update your name, bio, and avatar
• Settings — Personal preferences (theme, language, email notifications)
• Help — Links to documentation and support
• Sign Out — Log out of define.wtf

Mobile Navigation

On mobile devices, the layout adjusts to fit smaller screens:

• Main navigation becomes a hamburger menu
• The command palette (Cmd+K) still works
• The floating action button is more prominent for quick access
• Tap your profile icon to access the user menu

---

Now that you understand the layout, check out the User Guide for detailed how-tos on using specific features.