influxdata / influxdata/docs-v2

Clarify timestamp precision and its relationship to writing data

Open
#4,429 0 comments 0 reactions 0 assignees View on GitHub
OSS source:feedback
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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.