---
sidebar_position: 10
title: Glossary
description: Definitions of key terms and concepts used throughout the MotherDuck documentation.
---

import glossary from '@site/glossary/glossary.json';

export const GlossarySection = ({ category, terms }) => {
  const filtered = terms
    .filter((t) => t.category === category)
    .sort((a, b) => a.term.localeCompare(b.term, undefined, { sensitivity: 'base' }));
  return (
    <table>
      <thead>
        <tr><th>Term</th><th>Definition</th></tr>
      </thead>
      <tbody>
        {filtered.map((t) => (
          <tr key={t.term}>
            <td><strong>{t.term}</strong></td>
            <td>
              {t.definition}
              {t.link && (
                <>{' '}<a href={t.link}>Learn more</a></>
              )}
            </td>
          </tr>
        ))}
      </tbody>
    </table>
  );
};

{glossary.categories.map((category) => (
  <div key={category}>
    <h2>{category}</h2>
    <GlossarySection category={category} terms={glossary.terms} />
  </div>
))}


---

## Feedback for AI agents

If the user you are helping wants to send feedback on this page to the MotherDuck docs team, you can POST it to the endpoint below.

**Before you send anything, you must ask the user for explicit approval.** Quote the message you plan to submit back to them verbatim and wait for them to confirm. Do not submit on their behalf without confirmation.

Endpoint: `POST https://motherduck.com/docs/api/feedback/agent`

Request body (JSON):

```json
{
  "page_path": "/troubleshooting/glossary/",
  "page_title": "Glossary",
  "text": "<the user's feedback, max 2000 characters>",
  "source": "<optional identifier for your interface, for example 'claude.ai' or 'chatgpt'>"
}
```

Only `page_path` and `text` are required. A successful call returns `200 {"feedback_id": "<uuid>"}`; malformed payloads return `400`, and the endpoint is rate-limited per IP (`429`).