kfaraz commented on code in PR #14964: URL: https://github.com/apache/druid/pull/14964#discussion_r1382313841
########## docs/operations/basic-cluster-tuning.md: ########## @@ -90,7 +90,7 @@ Tuning the cluster so that each Historical can accept 50 queries and 10 non-quer #### Segment Cache Size -For better query performance, do not allocate segment data to a Historical in excess of the system free memory. When `free system memory` is greater than or equal to `druid.segmentCache.locations`, the more segment data the Historical can be held in the memory-mapped segment cache. +For better query performance, do not allocate segment data to a Historical in excess of the system free memory. When `free system memory` is greater than or equal to `druid.segmentCache.locations`, the Historical's memory-mapped segment cache can be held in memory, rather than being paged to disk. Review Comment: Yeah, it makes sense to link the other doc here. But I think we should get rid of the second sentence altogether as there are other problems with it too. However, if we do want to keep that sentence, it could be a lot simpler, like ``` The Historical uses free system memory to cache segments. ``` This sentence is easy to understand and clearly implies that the higher the free memory, the higher the number of segments that can be cached. The details are captured in the other doc anyway. -- 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: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
