[DOCS-9757] Comment on: "manual/reference/operator/aggregation/collStats.txt" Created: 11/Jan/17  Updated: 30/Oct/23

Status: Closed
Project: Documentation
Component/s: manual, Server
Affects Version/s: None
Fix Version/s: Server_Docs_20231030

Type: Bug Priority: Major - P3
Reporter: Kay Agahd Assignee: Unassigned
Resolution: Won't Do Votes: 0
Labels: collector-298ba4e7, docs-triage
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified
Environment:

Linux (OS should not matter)

Location: https://docs.mongodb.com/master/reference/operator/aggregation/collStats/#pipe._S_collStats
User-Agent: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:50.0) Gecko/20100101 Firefox/50.0
Referrer: https://docs.mongodb.com/master/release-notes/3.4/?_ga=1.246429376.593419234.1408566984
Screen Resolution: 1366 x 768


Participants:
Days since reply: 1 year, 14 weeks, 2 days ago
Epic Link: DOCSP-1769

 Description   

I'm referring to:
https://docs.mongodb.com/master/reference/operator/aggregation/collStats/#pipe._S_collStats

1)
Replace:
"Returns statistics regarding a collection or view."
With:
"Returns statistics regarding a collection or view either since server start or since creation of collection or view whatever happened later."
Why I think this is important:
Because it was unclear to me which time span the statistics cover.

2)
Replace:
"An array of embedded documents, each representing a latency range. Each document covers twice the previous document’s range. For upper values between 2048 microseconds and roughly 1 second, the histogram includes half-steps."
With:
"An array of embedded documents, each representing a latency range. Ranges are powers of two, so each document covers twice the previous document’s range as long as the range was not empty and thus not omitted. For values greater than 2048 microseconds the histogram includes half-steps."
Why I think this is important:
Speaking of powers of 2 is much clearer to every computer scientist than to say "covers twice the previous document's range". The latter is furthermore wrong when empty ranges are omitted.
Speaking of "...between 2048 microseconds and roughly 1 second..." is simply wrong. It let me wrongly think that either half-steps are only included from 2048 micros to 1 second and after 1 second there no half-steps anymore or there are no ranges at all after 1 second. I had to figure out by myself that half-steps are included always after 2048 micros, even after 1 second or more.



 Comments   
Comment by Education Bot [ 31/Oct/22 ]

Hello! This ticket has been closed due to inactivity. If you believe this ticket is still important, please reopen it and leave a comment to explain why. Thank you!

Generated at Thu Feb 08 07:59:05 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.