Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 28 additions & 12 deletions .gemini/skills/docs-writer/quota-limit-style-guide.md
Original file line number Diff line number Diff line change
@@ -1,45 +1,61 @@
# Style Guide: Quota vs. Limit

This guide defines the usage of "quota," "limit," and related terms in user-facing interfaces.
This guide defines the usage of "quota," "limit," and related terms in
user-facing interfaces.

## TL;DR

- **`quota`**: The administrative "bucket." Use for settings, billing, and requesting increases. (e.g., "Adjust your storage **quota**.")
- **`limit`**: The real-time numerical "ceiling." Use for error messages when a user is blocked. (e.g., "You've reached your request **limit**.")
- **When blocked, combine them:** Explain the **limit** that was hit and the **quota** that is the remedy. (e.g., "You've reached the request **limit** for your developer **quota**.")
- **Related terms:** Use `usage` for consumption tracking, `restriction` for fixed rules, and `reset` for when a limit refreshes.
- **`quota`**: The administrative "bucket." Use for settings, billing, and
requesting increases. (e.g., "Adjust your storage **quota**.")
- **`limit`**: The real-time numerical "ceiling." Use for error messages when a
user is blocked. (e.g., "You've reached your request **limit**.")
- **When blocked, combine them:** Explain the **limit** that was hit and the
**quota** that is the remedy. (e.g., "You've reached the request **limit** for
your developer **quota**.")
- **Related terms:** Use `usage` for consumption tracking, `restriction` for
fixed rules, and `reset` for when a limit refreshes.

---

## Detailed Guidelines

### Definitions

- **Quota is the "what":** It identifies the category of resource being managed (e.g., storage quota, GPU quota, request/prompt quota).
- **Quota is the "what":** It identifies the category of resource being managed
(e.g., storage quota, GPU quota, request/prompt quota).
- **Limit is the "how much":** It defines the numerical boundary.

Use **quota** when referring to the administrative concept or the request for more. Use **limit** when discussing the specific point of exhaustion.
Use **quota** when referring to the administrative concept or the request for
more. Use **limit** when discussing the specific point of exhaustion.

### When to use "quota"

Use this term for **account management, billing, and settings.** It describes the entitlement the user has purchased or been assigned.
Use this term for **account management, billing, and settings.** It describes
the entitlement the user has purchased or been assigned.

**Examples:**

- **Navigation label:** Quota and usage
- **Contextual help:** Your **usage quota** is managed by your organization. To request an increase, contact your administrator.
- **Contextual help:** Your **usage quota** is managed by your organization. To
request an increase, contact your administrator.

### When to use "limit"

Use this term for **real-time feedback, notifications, and error messages.** It identifies the specific wall the user just hit.
Use this term for **real-time feedback, notifications, and error messages.** It
identifies the specific wall the user just hit.

**Examples:**

- **Error message:** You’ve reached the 50-request-per-minute **limit**.
- **Inline warning:** Input exceeds the 32k token **limit**.

### How to use both together

When a user is blocked, combine both terms to explain the **event** (limit) and the **remedy** (quota).
When a user is blocked, combine both terms to explain the **event** (limit) and
the **remedy** (quota).

**Example:**

- **Heading:** Daily usage limit reached
- **Body:** You've reached the maximum daily capacity for your developer quota. To continue working today, upgrade your quota.
- **Body:** You've reached the maximum daily capacity for your developer quota.
To continue working today, upgrade your quota.
Loading