influxdata / influxdata/docs-v2
Clarify timestamp precision and its relationship to writing data
- Dominant language
- JavaScript
- Stars
- 82
- Forks
- 326
- Avg merge
- 1d 1h
- Merged PRs (30d)
- 82
Description
The user is looking for information about timestamp precision and is confused because the “unix timestamp” definition in the glossary has a link to “writing data to InfluxDB” which contains no information about timestamp precision.
See “unix timestamp” glossary item here:
https://docs.influxdata.com/influxdb/v2.3/reference/glossary/#unix-timestamp
This is a little confusing as the relationship between timestamp precision and writing data is not clearly outlined here.
Can we add some language to clarify the relationship and best practices for specifying timestamp precision when writing data?
This page has a better description but might cause the same kind of confusion:
https://docs.influxdata.com/influxdb/v2.3/write-data/best-practices/optimize-writes/#use-the-coarsest-time-precision-possible
New user feedback!
Page: https://docs.influxdata.com/influxdb/v2.3/write-data/
Feedback: this site is linked for information about timestamp precision but there is no word about it.
Contributor guide
No contributing guide indexed for this repository
Research direction
Start with the “unix timestamp” glossary entry and the linked write-data page, then compare the “Use the coarsest time precision possible” guidance in the best-practices page. Clarify how timestamp precision relates to writing data and describe best practices for specifying it, so the linked pages no longer leave the relationship unexplained.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100