Skip to content

docs: add documentation for timeseries#83

Merged
dkharms merged 2 commits into
mainfrom
82-docs-for-timeseries
Aug 18, 2025
Merged

docs: add documentation for timeseries#83
dkharms merged 2 commits into
mainfrom
82-docs-for-timeseries

Conversation

@dkharms
Copy link
Copy Markdown
Member

@dkharms dkharms commented Aug 17, 2025

Closes #82

Summary by CodeRabbit

  • Documentation
    • Documented time-interval (timeseries) support in GetAggregation, showing how aggregations compute statistics within intervals.
    • Clarified that UNIQUE aggregation is not supported for timeseries calculations.
    • Added two COUNT (with interval) request/response examples demonstrating time-bucketed counts with per-bucket timestamps and group_by keys (placed in two locations for discoverability).
    • Minor formatting cleanup (trailing newline).

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Aug 17, 2025

📝 Walkthrough

Walkthrough

Updated English and Russian public API docs to describe timeseries-capable aggregations, note AGG_FUNC_UNIQUE is not supported in timeseries, and add COUNT-with-interval request/response examples (duplicated in each doc). Minor formatting adjustment (trailing newline).

Changes

Cohort / File(s) Summary
Docs — EN
docs/en/10-public-api.md
Added timeseries aggregation description for GetAggregation; annotated AGG_FUNC_UNIQUE as not supported in timeseries; inserted two COUNT-with-interval examples (duplicated); added trailing newline.
Docs — RU
docs/ru/10-public-api.md
Added timeseries aggregation description for GetAggregation; annotated AGG_FUNC_UNIQUE as not supported in timeseries; inserted two COUNT-with-interval examples (duplicated); added trailing newline.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Assessment against linked issues

Objective Addressed Explanation
Add documentation for timeseries (#82)

Tip

🔌 Remote MCP (Model Context Protocol) integration is now available!

Pro plan users can now connect to remote MCP servers from the Integrations page. Connect with popular remote MCPs such as Notion and Linear to add more context to your reviews and chats.

✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch 82-docs-for-timeseries

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (4)
docs/ru/10-public-api.md (2)

182-182: Wording and terminology: replace “таймсерии” and fix agreement

Use the standard Russian term and tighten the phrasing.

-Полям документов, соответствующим запросу. Также агрегации поддерживают вычисление статистических значений среди различных временных интервалов (также известные как таймсерии).
+полям документов, соответствующим запросу. Также агрегации поддерживают вычисление статистических значений по различным временным интервалам (временные ряды, time series).

199-199: Consistency: “таймсерий” → “тайм-серий” (or use “временных рядов”)

Use consistent terminology and correct hyphenation.

-- `AGG_FUNC_UNIQUE` — вычисление уникальных значений поля (не поддерживается для вычисления таймсерий)
+- `AGG_FUNC_UNIQUE` — вычисление уникальных значений поля (не поддерживается для тайм-серий)
docs/en/10-public-api.md (2)

182-182: Minor wording: “timeseries” → “time series”; streamline phrasing

Small editorial polish for readability.

-that match the query. Also aggregations support computation of statistical values within different time intervals (also known as timeseries).
+that match the query. Aggregations also support computing statistical values across time intervals (also known as time series).

198-199: Clarify scope: UNIQUE not supported “for time-series aggregations”

This is a bit clearer than “in timeseries”.

-- `AGG_FUNC_UNIQUE` — computation of unique field values (not supported in timeseries)
+- `AGG_FUNC_UNIQUE` — computation of unique field values (not supported for time-series aggregations)
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 53031b9 and 4f2f49c.

📒 Files selected for processing (2)
  • docs/en/10-public-api.md (4 hunks)
  • docs/ru/10-public-api.md (4 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/ru/10-public-api.md

[grammar] ~182-~182: Ensure spelling is correct
Context: ...и различных временных интервалов (также известные как таймсерии). Агрегации можно вызыва...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

Comment thread docs/en/10-public-api.md
Comment thread docs/ru/10-public-api.md
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

♻️ Duplicate comments (1)
docs/ru/10-public-api.md (1)

444-491: COUNT-with-interval example: JSON and headings look correct now.

Trailing/missing commas are fixed, and headings localized to Russian. The interval usage and ts stepping are coherent.

🧹 Nitpick comments (1)
docs/ru/10-public-api.md (1)

182-182: Fix grammatical agreement and terminology (“тайм‑серии”).

Parenthetical should agree with “временных интервалов” and use the standard term.

Apply this diff:

- полям документов, соответствующим запросу. Также агрегации поддерживают вычисление статистических значений среди различных временных интервалов (также известные как таймсерии).
+ полям документов, соответствующим запросу. Также агрегации поддерживают вычисление статистических значений среди различных временных интервалов (также известных как тайм-серии).
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 4f2f49c and fed98d1.

📒 Files selected for processing (2)
  • docs/en/10-public-api.md (4 hunks)
  • docs/ru/10-public-api.md (4 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/en/10-public-api.md
🧰 Additional context used
🪛 LanguageTool
docs/ru/10-public-api.md

[grammar] ~182-~182: Ensure spelling is correct
Context: ...и различных временных интервалов (также известные как таймсерии). Агрегации можно вызыва...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

🔇 Additional comments (1)
docs/ru/10-public-api.md (1)

199-199: Good clarification about UNIQUE in time series.

Explicitly noting that AGG_FUNC_UNIQUE isn’t supported for time-series is helpful and prevents misuse.

@codecov-commenter
Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 73.46%. Comparing base (53031b9) to head (fed98d1).

Additional details and impacted files
@@            Coverage Diff             @@
##             main      #83      +/-   ##
==========================================
+ Coverage   73.44%   73.46%   +0.01%     
==========================================
  Files         193      193              
  Lines       16015    16015              
==========================================
+ Hits        11762    11765       +3     
+ Misses       3662     3660       -2     
+ Partials      591      590       -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@dkharms dkharms merged commit 0b406d7 into main Aug 18, 2025
5 checks passed
@dkharms dkharms deleted the 82-docs-for-timeseries branch August 18, 2025 11:33
@coderabbitai coderabbitai Bot mentioned this pull request Aug 20, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add documentation for timeseries

4 participants