Skip to content

Update Sheets docs: add sheet type, fix functions_operators accuracy#35359

Open
revaranka wants to merge 5 commits intomasterfrom
reva.ranka/sheets-add-flexible-spreadsheet-docs
Open

Update Sheets docs: add sheet type, fix functions_operators accuracy#35359
revaranka wants to merge 5 commits intomasterfrom
reva.ranka/sheets-add-flexible-spreadsheet-docs

Conversation

@revaranka
Copy link
Contributor

Summary

  • Restructures _index.md around the three named product types (table, pivot table, sheet) — overview now introduces all three upfront, and calculated columns/lookup are grouped under the Table section
  • Adds new Sheet (Preview) section with cell reference syntax, cross-sheet/table column reference syntax, formula overview with link to functions page, error values table, worked examples, cell formatting, and row/column limits
  • Fixes functions_operators.md accuracy based on the actual function registry in web-ui:
    • Removes ADD, MINUS, MULTIPLY, DIVIDE — these functions don't exist in the codebase
    • Adds missing table functions: SUBSTITUTE, REGEXREPLACE
    • Marks REGEXREPLACE as table calculated columns only (its scope in the registry is table, not open)
    • Adds operators Example column
    • Adds full Sheet functions section (sheet-only functions, i.e. open scope) organized by category: Text, Logical, Math, Date/time, Lookup & reference, Statistical, Financial, Info

Test plan

  • Preview build link posts from the GitHub bot — check rendered pages for broken links and formatting
  • Verify Sheet (Preview) section renders the callout correctly
  • Verify anchor #sheet-functions resolves correctly from _index.md link

🤖 Generated with Claude Code

- Restructure _index.md around three named types (table, pivot table, sheet)
- Move calculated columns and lookup under Table section
- Move flexible spreadsheet callout to new Sheet (Preview) section
- Add Sheet section: cell references, cross-sheet references, formula overview,
  error values, examples, cell formatting, and row/column limits
- Update functions_operators.md overview to cover both table calculated columns
  and sheet formulas
- Add missing table functions: SUBSTITUTE, REGEXREPLACE
- Remove ADD, MINUS, MULTIPLY, DIVIDE (not implemented)
- Mark REGEXREPLACE as table calculated columns only (not available in sheets)
- Add Sheet functions section with: Text, Logical, Math, Date/time,
  Lookup & reference, Statistical, Financial, and Info categories
- Add operators Example column

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions
Copy link
Contributor

…eenshot

- Update overview to introduce three tab types with anchor links
- Restructure Table section intro copy
- Move Sheet (Preview) callout into its section; add flexible_spreadsheet.png
- Move Examples as subsection under Formulas
- Combine Table functions and Sheet functions into a single Functions section
  with an Available in column (Table, Sheet, or Table, Sheet)
- Update statistical and math examples to use table column references
  where supported (e.g. COUNTIF('Logs'#"status", "error"))

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions bot added the Images Images are added/removed with this PR label Mar 18, 2026
revaranka and others added 3 commits March 18, 2026 13:51
…Formulas

- Standardize all function table column separators to equal widths
- Move Examples as a subsection (####) directly under Formulas in Sheet section

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…s table

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@revaranka revaranka marked this pull request as ready for review March 18, 2026 21:14
@revaranka revaranka requested a review from a team as a code owner March 18, 2026 21:14
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5d821f1ca3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[18]: https://app.datadoghq.com/apm/traces
[19]: https://www.datadoghq.com/product-preview/additional-advanced-querying-data-sources/
[20]: https://app.datadoghq.com/product-analytics/events
[21]: /sheets/functions_operators#sheet-functions

Choose a reason for hiding this comment

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

P2 Badge Fix broken anchor for Sheet functions link

The new reference target [21]: /sheets/functions_operators#sheet-functions points to an anchor that does not exist in functions_operators.md (that page has headings like ## Functions, but no ## Sheet functions). As a result, users clicking the “Sheet functions” link in the Sheets page cannot navigate to the intended section, which is a regression in cross-page docs navigation. Update the link to an existing anchor or add a matching heading on the destination page.

Useful? React with 👍 / 👎.

@urseberry
Copy link
Contributor

https://datadoghq.atlassian.net/browse/DOCS-13757 created for documentation team review

@urseberry urseberry added the editorial review Waiting on a more in-depth review label Mar 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

editorial review Waiting on a more in-depth review Images Images are added/removed with this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants