Skip to content

Docs: date UDF updates + OGM client libraries section#378

Open
shahar-biron wants to merge 7 commits intomainfrom
udfs-date-md-updates
Open

Docs: date UDF updates + OGM client libraries section#378
shahar-biron wants to merge 7 commits intomainfrom
udfs-date-md-updates

Conversation

@shahar-biron
Copy link
Contributor

@shahar-biron shahar-biron commented Feb 24, 2026

This PR now contains the non-browser documentation updates (split out from the browser UI docs).

Changes:

  • Update FLEX date UDF docs (format/truncate)
  • Add/adjust Object-Graph Mapping (OGM) / client libraries section + related spellcheck tweaks

Browser UI documentation is now in PR #379 (standalone branch).

shahar-biron and others added 7 commits February 4, 2026 12:52
- Add new section for Official ORM libraries below Official Clients
- Include falkordb-py-orm (Python)
- Include falkordb-go-orm (Go)
- Include spring-data-falkordb (Java)
- Add reference links for all ORM libraries

Co-Authored-By: Warp <agent@warp.dev>
Co-Authored-By: Warp <agent@warp.dev>
Co-Authored-By: Warp <agent@warp.dev>
Update terminology from Object-Relational Mapping (ORM) to Object-Graph
Mapping (OGM) which is the correct term for graph databases. ORM refers
to mapping objects to relational database tables, while OGM maps objects
to graph structures (nodes and edges).

- Update section heading and description
- Keep all link references intact (falkordb-py-orm, falkordb-go-orm)
- Add OGM and ogm to wordlist for spellcheck

Co-Authored-By: Warp <agent@warp.dev>
Co-Authored-By: Warp <agent@warp.dev>
Co-Authored-By: Warp <agent@warp.dev>
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 24, 2026

📝 Walkthrough

Walkthrough

This pull request expands documentation across three areas: removes an entry from the wordlist, adds comprehensive UI documentation for the FalkorDB Browser interface, and updates date UDF documentation with improved formatting and a new units table.

Changes

Cohort / File(s) Summary
Wordlist Cleanup
.wordlist.txt
Removed single entry "lowercasing" from exported wordlist.
Browser Navigation and Index
browser/index.md
Added has_children: true metadata and new "UI elements" section with link to UI documentation.
Browser UI Documentation
browser/ui/chat-panel.md, browser/ui/data-panel.md, browser/ui/graph-canvas.md, browser/ui/graph-info-panel.md, browser/ui/graph-page.md, browser/ui/index.md, browser/ui/login.md, browser/ui/metadata-view.md, browser/ui/navigation.md, browser/ui/query-editor.md, browser/ui/query-history.md, browser/ui/settings.md, browser/ui/style-panel.md, browser/ui/table-view.md, browser/ui/toolbar-actions.md
Added 15 new comprehensive documentation files covering all major UI components: chat panel, data/property panel, graph canvas, graph info panel, graph page layout, login screen, metadata view, navigation, query editor, query history, settings, style panel, table view, and toolbar actions. Each file includes front matter, descriptions, features, and user interactions.
UDF Documentation Updates
udfs/flex/date/format.md, udfs/flex/date/truncate.md
Updated format.md with inline code formatting for the Z token. Added new "Supported Units" table to truncate.md documenting minute, hour, day, week, month, quarter, and year units with their truncation behavior.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~4 minutes

Poem

🐰 Through docpages bright, a warren we've built,
Where UI designs are thoroughly gilt,
From login to chat, from data to style,
Our browser's now mapped, mile after mile! ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Title check ⚠️ Warning The PR title mentions 'date UDF updates' which is minimally represented in the changes, but largely focuses on comprehensive Browser UI documentation which is not mentioned in the title. Update the title to reflect the primary change: 'Docs: Browser UI documentation + date UDF updates' or similar, as the Browser documentation comprises the majority of this changeset.
✅ Passed checks (2 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
  • 📝 Generate docstrings (stacked PR)
  • 📝 Generate docstrings (commit on current branch)
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch udfs-date-md-updates

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

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@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: 1

🧹 Nitpick comments (1)
browser/ui/table-view.md (1)

12-14: Avoid internal API naming in user docs.
“graph.Data” reads like an internal type; consider phrasing as “non‑empty tabular results” only.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@browser/ui/table-view.md` around lines 12 - 14, Replace the internal API type
name "graph.Data" in the sentence describing when the Table tab is enabled with
a user-friendly phrase such as "non‑empty tabular results"; locate the
occurrence of the symbol "graph.Data" in the Table tab description and update
the copy to remove the internal type reference and use plain wording (e.g.,
"when the current query produced non‑empty tabular results").
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@browser/ui/navigation.md`:
- Around line 12-13: Update the UI copy under the "Main navigation buttons"
section to use "username" as a single word instead of "user name" in the phrase
"user name/version block" so it reads "username/version block"; ensure any other
occurrences in this document follow the same "username" spelling.

---

Nitpick comments:
In `@browser/ui/table-view.md`:
- Around line 12-14: Replace the internal API type name "graph.Data" in the
sentence describing when the Table tab is enabled with a user-friendly phrase
such as "non‑empty tabular results"; locate the occurrence of the symbol
"graph.Data" in the Table tab description and update the copy to remove the
internal type reference and use plain wording (e.g., "when the current query
produced non‑empty tabular results").

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 9b21c87 and 20cd3fc.

📒 Files selected for processing (19)
  • .wordlist.txt
  • browser/index.md
  • browser/ui/chat-panel.md
  • browser/ui/data-panel.md
  • browser/ui/graph-canvas.md
  • browser/ui/graph-info-panel.md
  • browser/ui/graph-page.md
  • browser/ui/index.md
  • browser/ui/login.md
  • browser/ui/metadata-view.md
  • browser/ui/navigation.md
  • browser/ui/query-editor.md
  • browser/ui/query-history.md
  • browser/ui/settings.md
  • browser/ui/style-panel.md
  • browser/ui/table-view.md
  • browser/ui/toolbar-actions.md
  • udfs/flex/date/format.md
  • udfs/flex/date/truncate.md
💤 Files with no reviewable changes (1)
  • .wordlist.txt

Comment on lines +12 to +13
## Main navigation buttons
Located in the sidebar under the user name/version block:
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Consider “username” as one word.
“user name” is typically written as “username” in UI docs.

🧰 Tools
🪛 LanguageTool

[style] ~13-~13: It’s more common nowadays to write this noun as one word.
Context: ...uttons Located in the sidebar under the user name/version block: - SETTINGS → opens `...

(RECOMMENDED_COMPOUNDS)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@browser/ui/navigation.md` around lines 12 - 13, Update the UI copy under the
"Main navigation buttons" section to use "username" as a single word instead of
"user name" in the phrase "user name/version block" so it reads
"username/version block"; ensure any other occurrences in this document follow
the same "username" spelling.

@shahar-biron shahar-biron changed the title Browser: detailed UI documentation Docs: date UDF updates + OGM client libraries section Feb 24, 2026
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.

2 participants