Skip to main content

alwaysApply: true

description: "Terminology consistency guidelines for documentation"

Terminology Consistency Guidelines

Database Technology

  • Postgres (preferred)
  • ❌ PostgreSQL (use only when absolutely necessary for technical accuracy)

Company Name

  • PostgresAI (no space, no dot)
  • ❌ Postgres AI (old branding with space)
  • ❌ Postgres.ai (old branding with dot)
  • ❌ postgres.ai (lowercase)

Documentation Sections

  • "how-to guides" (full form in titles and descriptions)
  • "how-tos" (acceptable in short contexts like menus, navigation)
  • ❌ "HowTo guides" (inconsistent capitalization)
  • ❌ "HowTos" (inconsistent capitalization)

Product Names

  • DBLab (current branding)
  • DBLab Engine (full product name)
  • postgres_ai monitoring
  • pg_index_pilot
  • ❌ DLE (deprecated abbreviation)
  • ❌ Database Lab (old name, deprecated)
  • ❌ Database Lab Engine (old name, deprecated)
  • ❌ Postgres.AI monitoring
  • ❌ Index Pilot

Usage Examples

Correct Usage:

  • "DBLab Engine enables database branching for Postgres"
  • "Visit the PostgresAI documentation"
  • "Check out our how-to guides for detailed instructions"
  • "Navigate to how-tos in the sidebar"

Incorrect Usage:

  • "DLE enables database branching for PostgreSQL"
  • "Visit the Postgres.ai documentation"
  • "Check out our HowTo guides for detailed instructions"
  • "Navigate to HowTos in the sidebar"

Special Cases

  • Environment variables with "DLE_" prefix should remain unchanged for backward compatibility
  • Historical blog posts may preserve original terminology when updating would change meaning
  • Technical documentation requiring precise PostgreSQL references (like official extension names)