[GitHub] [pulsar-site] zuobiao-zhou commented on a diff in pull request #674: seo for C&A

["zuobiao-zhou (via GitHub)" <gi...@apache.org>]

zuobiao-zhou commented on code in PR #674:
URL: https://github.com/apache/pulsar-site/pull/674#discussion_r1290943845


##########
docs/reference-terminology.md:
##########
@@ -78,18 +67,6 @@ A group of namespaces that have anti-affinity to each other.
 A lightweight Pulsar broker in which all components run in a single Java Virtual Machine (JVM) process. Standalone
 clusters can be run on a single machine and are useful for development purposes.
 
-### Cluster

Review Comment:
   As we have included the definitions of certain terms in the Concepts and Architecture chapter, redundant terminology definitions would add to the maintenance complexity. Users can refer to this chapter when seeking the definitions of specific terms.
   
   Perhaps we can place a link at the repeated term's location in "reference-terminology.md" as a substitute for those redundant definitions?
   
   e.g.
   ## Producer
   See [here](https://pulsar.apache.org/docs/next/concepts-clients/#producer).
   
   On the other hand, for instance, when a user searches for "what is Pulsar brokers," we expect the result is https://pulsar.apache.org/docs/next/concepts-architecture-overview instead of https://pulsar.apache.org/docs/next/reference-terminology/. Repetitive definitions would disperse the weight of the expected page.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@pulsar.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org