<commit_before>#
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements.  See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership.  The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License.  You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied.  See the License for the
# specific language governing permissions and limitations
# under the License.
#

ack:
  q: What is an acknowledgement (ack)?
  def: A message sent to a Pulsar broker by a consumer that a message has been successfully processed. An acknowledgement (ack) is Pulsar's way of knowing that the message can be deleted from the system; if no acknowledgement, then the message will be retained until it's processed.
bookie:
  q: What is a bookie?
  def: Bookie is just a nickname for an individual BookKeeper server.
bookkeeper:
  q: What is BookKeeper?
  def: Apache BookKeeper is a persistent log storage system that Pulsar uses to store message data.
broker:
  q: What is a broker?
  def:
    "A stateless component of Pulsar clusters that runs two other components: an HTTP server exposing a REST interface for administration and topic lookup and a dispatcher that handles all message transers. Pulsar clusters typically consist of multiple brokers."
cluster:
  q: What is a cluster?
  def: A set of Pulsar brokers and BookKeeper servers (aka bookies). Clusters can reside in different geographical regions and replicate messages to one another in a process called geo-replication.
configuration-store:
  q: What is the configuration store?
  def: |
    Pulsar's configuration store (previously known as global ZooKeeper) is a ZooKeeper quorum that is used for configuration-specific tasks. A multi-cluster Pulsar installation requires just one configuration store across all clusters.
consumer:
  q: What is a consumer?
  def: A process that establishes a subscription to a Pulsar topic and processes messages published to that topic by producers.
cursor:
  q: What is a cursor?
  def: The subscription position for a consumer.
discovery:
  q: What is (service) discovery in Pulsar?
  def: A mechanism provided by Pulsar that enables connecting clients to use just a single URL to interact with all the brokers in a cluster.
dispatcher:
  q: What is a dispatcher?
  def: An asynchronous TCP server used for all data transfers in a Pulsar cluster. The Pulsar dispatcher uses a custom binary protocol for all communications.
geo-replication:
  q: What is geo-replication?
  def: Replication of messages across Pulsar clusters, potentially in different datacenters or geographical regions.
global-topic:
  q: What is a global topic?
  def: A topic that belongs to a global, instance-wide namespace and thus isn't tied to any specific cluster.
instance:
  q: What is a Pulsar instance?
  def: A group of Pulsar clusters that act together as a single unit.
ledger:
  q: What is a ledger?
  def: An append-only data structure in BookKeeper that is used to persistently store messages in Pulsar topics.
message:
  q: What is a message in Pulsar?
  def: Messages are the basic "unit" of Pulsar. They're what producers publish to topics and what consumers then consume from topics.
multi-tenancy:
  q: What is multi-tenancy?
  def: The ability to isolate namespaces, specify quotas, and configure authentication and authorization on a per-property basis.
namespace:
  q: What is a namespace?
  def: A grouping mechanism for related topics.
namespace-bundle:
  q: What is a namespace bundle?
  def: |
    A virtual group of topics that belong to the same namespace. A namespace bundle is defined as a range between two 32-bit hashes, such as 0x00000000 and 0xffffffff.
partitioned-topic:
  q: What is a partitioned topic?
  def: A topic that is served by multiple Pulsar brokers, which enables higher throughput.
producer:
  q: What is a producer?
  def: A process that publishes messages to a Pulsar topic.
property:
  q: What is a property?
  def: A Pulsar tenant.
pub-sub:
  q: What is the publish-subscribe pattern (pub-sub)?
  def: A messaging pattern in which publisher proccesses publish messages on topics that are then consumed (processed) by consumer processes.
pulsar:
  q: What is Pulsar?
  def: Pulsar is a distributed messaging system originally created by Yahoo but now under the stewardship of the Apache Software Foundation.
pulsar-functions:
  q: What are Pulsar Functions?
  def: Pulsar Functions are lightweight functions that can consume messages from Pulsar topics, apply custom processing logic, and, if desired, publish results to topics.
retention-policy:
  q: What is a retention policy?<commit_msg>Fixed message popover def (#1986)<commit_after>#
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements.  See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership.  The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License.  You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied.  See the License for the
# specific language governing permissions and limitations
# under the License.
#

ack:
  q: What is an acknowledgement (ack)?
  def: A message sent to a Pulsar broker by a consumer that a message has been successfully processed. An acknowledgement (ack) is Pulsar's way of knowing that the message can be deleted from the system; if no acknowledgement, then the message will be retained until it's processed.
bookie:
  q: What is a bookie?
  def: Bookie is just a nickname for an individual BookKeeper server.
bookkeeper:
  q: What is BookKeeper?
  def: Apache BookKeeper is a persistent log storage system that Pulsar uses to store message data.
broker:
  q: What is a broker?
  def:
    "A stateless component of Pulsar clusters that runs two other components: an HTTP server exposing a REST interface for administration and topic lookup and a dispatcher that handles all message transers. Pulsar clusters typically consist of multiple brokers."
cluster:
  q: What is a cluster?
  def: A set of Pulsar brokers and BookKeeper servers (aka bookies). Clusters can reside in different geographical regions and replicate messages to one another in a process called geo-replication.
configuration-store:
  q: What is the configuration store?
  def: |
    Pulsar's configuration store (previously known as global ZooKeeper) is a ZooKeeper quorum that is used for configuration-specific tasks. A multi-cluster Pulsar installation requires just one configuration store across all clusters.
consumer:
  q: What is a consumer?
  def: A process that establishes a subscription to a Pulsar topic and processes messages published to that topic by producers.
cursor:
  q: What is a cursor?
  def: The subscription position for a consumer.
discovery:
  q: What is (service) discovery in Pulsar?
  def: A mechanism provided by Pulsar that enables connecting clients to use just a single URL to interact with all the brokers in a cluster.
dispatcher:
  q: What is a dispatcher?
  def: An asynchronous TCP server used for all data transfers in a Pulsar cluster. The Pulsar dispatcher uses a custom binary protocol for all communications.
geo-replication:
  q: What is geo-replication?
  def: Replication of messages across Pulsar clusters, potentially in different datacenters or geographical regions.
global-topic:
  q: What is a global topic?
  def: A topic that belongs to a global, instance-wide namespace and thus isn't tied to any specific cluster.
instance:
  q: What is a Pulsar instance?
  def: A group of Pulsar clusters that act together as a single unit.
ledger:
  q: What is a ledger?
  def: An append-only data structure in BookKeeper that is used to persistently store messages in Pulsar topics.
message:
  q: What is a message in Pulsar?
  def: Messages are the basic unit of Pulsar. They're what producers publish to topics and what consumers then consume from topics.
multi-tenancy:
  q: What is multi-tenancy?
  def: The ability to isolate namespaces, specify quotas, and configure authentication and authorization on a per-property basis.
namespace:
  q: What is a namespace?
  def: A grouping mechanism for related topics.
namespace-bundle:
  q: What is a namespace bundle?
  def: |
    A virtual group of topics that belong to the same namespace. A namespace bundle is defined as a range between two 32-bit hashes, such as 0x00000000 and 0xffffffff.
partitioned-topic:
  q: What is a partitioned topic?
  def: A topic that is served by multiple Pulsar brokers, which enables higher throughput.
producer:
  q: What is a producer?
  def: A process that publishes messages to a Pulsar topic.
property:
  q: What is a property?
  def: A Pulsar tenant.
pub-sub:
  q: What is the publish-subscribe pattern (pub-sub)?
  def: A messaging pattern in which publisher proccesses publish messages on topics that are then consumed (processed) by consumer processes.
pulsar:
  q: What is Pulsar?
  def: Pulsar is a distributed messaging system originally created by Yahoo but now under the stewardship of the Apache Software Foundation.
pulsar-functions:
  q: What are Pulsar Functions?
  def: Pulsar Functions are lightweight functions that can consume messages from Pulsar topics, apply custom processing logic, and, if desired, publish results to topics.
retention-policy:
  q: What is a retention policy?
{'fraction_non_alphanumeric': 0.04707631318136769, 'fraction_numerical': 0.00356788899900892, 'mean_word_length': 4.291557420031463, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 4, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6404291', 'n_tokens_mistral': 2706, 'n_tokens_neox': 2568, 'n_words': 1505}