[jira] [Commented] (KAFKA-5114) Clarify meaning of logs in Introduction: Topics and Logs

["Michael Ernest (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/KAFKA-5114?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15995767#comment-15995767 ] 

Michael Ernest commented on KAFKA-5114:
---------------------------------------

What if a partition were described as a structured (ordered?) commit log, and a topic described as a collection of one or more partitions? In that way the hierarchy of these abstractions is clear, and it is also clear the properties of the partition are of course an aspect of its controlling topic.

> Clarify meaning of logs in Introduction: Topics and Logs
> --------------------------------------------------------
>
>                 Key: KAFKA-5114
>                 URL: https://issues.apache.org/jira/browse/KAFKA-5114
>             Project: Kafka
>          Issue Type: Improvement
>          Components: documentation
>            Reporter: Michael Ernest
>            Priority: Minor
>
> The term log is ambiguous in this section:
> * To describe a partition as a 'structured commit log'
> * To describe a topic as a partitioned log
> Then there's this sentence under Distribution: "The partitions of the log are distributed over the servers in the Kafka cluster with each server handling data and requests for a share of the partitions"
> In that last sentence, replacing 'log' with 'topic' would be clearer.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)