Streaming

Property Tooltips Test

Test page for Redpanda configuration property tooltips. Tooltips are opt-in: only code elements emitted by the prop: AsciiDoc macro (class property-ref plus a data-property-name attribute) are decorated. This page simulates the macro’s output with pass-through HTML because the UI preview doesn’t run the docs macros. To disable tooltips on a specific page, use :page-disable-property-tooltips: true.

Hover over property names to see documentation tooltips!

Cluster Properties in Paragraphs

When configuring Redpanda, you may need to adjust log_segment_size for optimal storage performance. The default segment size works for most workloads, but large messages may benefit from larger segments.

To enable authentication, set enable_sasl to true. This requires clients to authenticate using SASL mechanisms.

Topic Properties in Lists

Topic-level configuration properties:

  • retention_bytes - Controls maximum partition size before deletion

  • This is a topic-scoped property that can override cluster defaults

Dotted Property Names (Topic-scoped)

These properties use dot notation and test the anchor slugification fix:

  • redpanda.storage.mode - Controls storage mode (local vs tiered)

  • redpanda.remote.read - Enables remote reads from object storage

The "View full documentation" link for redpanda.storage.mode should generate an anchor like #redpanda-storage-mode (dots replaced with hyphens), not #redpanda.storage.mode.

Enterprise and Self-Hosted Properties

Some properties are enterprise-only:

  • cloud_storage_enabled - Requires Enterprise license (self-hosted only)

Broker Properties

Per-broker settings like kafka_connections_max control resource limits.

Macro Calls Inside Tooltip Descriptions

The group_max_session_timeout_ms tooltip description contains a prop: macro call and a legacy config_ref: call. Both must render as plain code in the tooltip, never as raw macro text.

Deprecated Properties

The property group_max_session_timeout_ms is deprecated but still shown with appropriate styling.

Display text override

The macro’s text attribute changes the display while keeping the lookup name: object storage flag should show the Tiered Storage property tooltip.

Unmarked property names get NO tooltip (the old false-positive case)

These are real property names in plain backticks, exactly what used to be auto-matched. With opt-in marking they must NOT have tooltips:

  • log_segment_size - No tooltip (not marked)

  • enable_sasl - No tooltip (not marked)

  • The admin listener in a Helm values file - No tooltip (ambiguous word)

Marked but unknown property

A marked element whose name is not in the published data renders untouched: this_is_not_a_property - No tooltip.

Properties in Code Blocks

redpanda:
  log_segment_size: 134217728
  enable_sasl: true

Non-Property Code

Regular code elements should NOT have tooltips:

  • this_is_not_a_property - No tooltip

  • some_random_function() - No tooltip

  • myVariable - No tooltip