Skip to content

Conversation

@danciaclara
Copy link
Collaborator

@danciaclara danciaclara commented Sep 18, 2025

Description

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • Feature (non-breaking change which adds functionality)
  • Improvement (change that would cause existing functionality to not work as expected)
  • Code refactoring
  • Performance improvements
  • Documentation update

Screenshots and Media (if applicable)

Test Scenarios

References

Summary by CodeRabbit

  • Documentation
    • Renamed “Display” to “Display options.”
    • Rewrote “Filters” as “Work item filters” with step‑by‑step guidance, expanded operator reference (including plan availability), enhanced date filter options, practical examples (urgent/overdue/unassigned), and an updated illustrative image.
    • Added guidance for managing filters (clear specific, clear all, save view).
    • Updated navigation: flattened Visualization by promoting Layouts, Work item filters, and Display options to top-level entries.

@vercel
Copy link

vercel bot commented Sep 18, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Sep 19, 2025 6:53am

@coderabbitai
Copy link

coderabbitai bot commented Sep 18, 2025

Caution

Review failed

The pull request is closed.

Walkthrough

Updated documentation: one page title changed, one filters doc fully rewritten and expanded with operator references and examples, and the documentation sidebar flattened by removing a nested "Layouts" category and promoting three pages to top-level items. No application code or exported API changes.

Changes

Cohort / File(s) Summary of Changes
Docs — Titles and content
docs/core-concepts/issues/display-options.mdx, docs/core-concepts/issues/visualise_filter.mdx
display-options.mdx title changed from "Display" to "Display options". visualise_filter.mdx renamed and fully rewritten from "Filters" to "Work item filters": new guided workflow, filter-building guidance, expanded operator reference (including plan-based availability), per-field operator tables, new image, and practical examples; content restructure only, no code.
Sidebar configuration
sidebars.ts
Flattened the Visualization section by removing the nested "Layouts" category and adding three top-level entries: core-concepts/issues/layouts, core-concepts/issues/visualise_filter, core-concepts/issues/display-options. Export signature unchanged.

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant DocsSite as Docs Site (Sidebar)
  rect rgba(135,206,235,0.12)
    Note over DocsSite: Sidebar structure updated (flattened Visualization)
  end
  User->>DocsSite: Open "Visualization" section
  DocsSite-->>User: Present top-level entries:
  Note right of DocsSite: - layouts<br/>- visualise_filter<br/>- display-options
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • Rich filters #353 — Mirrors these edits (renaming/rewrite of the Filters doc, display-options title change, and sidebar flattening); likely the same or closely related changes.

Poem

I nibble through the docs with cheer,
Filters bloom and titles clear.
The sidebar hops to smoother ground,
Three bright paths now easy found.
A tidy warren — small and dear. 🐇✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check ✅ Passed The changeset mainly rewrites and expands the Filters documentation into "Work item filters" (adding operator references, examples, and sidebar updates), so the title "Rich filters" is directly related and concisely signals that filters were enhanced.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between c1e6dba and b8cc0b1.

📒 Files selected for processing (1)
  • docs/core-concepts/issues/visualise_filter.mdx (1 hunks)

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

@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

🧹 Nitpick comments (7)
docs/core-concepts/issues/display-options.mdx (2)

19-27: Normalize property names to match UI and internal consistency.

Minor casing/terminology fixes; align with “Start date/Target date” used elsewhere.

Apply this diff:

- - Work item Type
+ - Type
- - Start Date
+ - Start date
- - Due Date
+ - Target date
- - Sub-work item Count
+ - Sub-work item count
- - Attachment Count
+ - Attachment count

33-56: Hyphenation/case nits (“Subgroup”, “Created by”).

Keep terminology consistent across docs.

Apply this diff:

-## Sub-group by
+## Subgroup by
@@
-You can further refine your view by adding a sub-grouping.
+You can further refine your view by adding a subgrouping.
@@
-- Created By
+- Created by
@@
-- Created By
+- Created by
docs/core-concepts/issues/visualise_filter.mdx (5)

33-36: Example uses “in” operator; reconcile with Operator availability section.

Either the “in” operator is supported (then reflect that in the Operator availability box), or update the example to avoid “in”.


41-44: Small correctness nits in the example (“empty” token and “Todo” spelling).

Apply this diff:

-**Review items without assignments:**
-- Set **Assignee** → is → [empty]
-- Add State → in → [Backlog, To Do]
+**Review items without assignments:**
+- Set **Assignee** → **is** → `No assignee`
+- Add **State** → **in** → [`Backlog`, `Todo`]

49-55: Clarify relative dates and use conventional operator names.

Avoid weekday ambiguity; prefer “start/end of this week”. Use “on or after/before”.

Apply this diff:

-**This week's deliverables:**
-- Set **Target date** → **between** → [Monday] and [Sunday]
+**This week's deliverables:**
+- Set **Target date** → **between** → [Start of this week] and [End of this week]
@@
-**Items starting soon:**
-- Set **Start Date** → **after or on** → [Today]
-- Add **Start Date** → **before or on** → [One week from today]
+**Items starting soon:**
+- Set **Start date** → **on or after** → [Today]
+- Add **Start date** → **on or before** → [One week from today]

75-81: Admonition syntax and forward‑looking statement.

Docusaurus admonitions typically use “:::info Title”. Also avoid promising future operators unless certain.

Apply this diff:

-:::info[Operator availability]
+:::info Operator availability
@@
-**Paid plans**  
-Unlock advanced filtering with additional operators including `is not`, `after`, `before`, and more specialized conditions. We will be adding more conditions here such as `in`, `contains`, `is empty`, etc. .
+**Paid plans**  
+Unlock advanced filtering with additional operators such as `is not`, `after`, and `before`. Availability can vary by plan.
 :::

167-179: Date operator list: simplify to commonly used, user‑friendly names.

Reduce cognitive load and match typical UI labels.

Apply this diff:

-| `before` | Earlier than this date | Due before Monday |
-| `not before` | This date or later | Not due before Monday (due Monday or later) |
-| `before or on` | This date or earlier | Due Monday or earlier |
-| `not before or on` | Later than this date | Not due Monday or earlier (due after Monday) |
-| `after` | Later than this date | Due after Friday |
-| `not after` | This date or earlier | Not due after Friday (due Friday or earlier) |
-| `after or on` | This date or later | Due Friday or later |
-| `not after or on` | Earlier than this date | Not due Friday or later (due before Friday) |
+| `before` | Earlier than this date | Due before Monday |
+| `on or before` | This date or earlier | Due Monday or earlier |
+| `after` | Later than this date | Due after Friday |
+| `on or after` | This date or later | Due Friday or later |
 | `between` | Within date range | Due this week |
 | `not between` | Outside date range | Not due this week |
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 972df21 and c1e6dba.

📒 Files selected for processing (3)
  • docs/core-concepts/issues/display-options.mdx (1 hunks)
  • docs/core-concepts/issues/visualise_filter.mdx (1 hunks)
  • sidebars.ts (1 hunks)
🔇 Additional comments (5)
docs/core-concepts/issues/display-options.mdx (2)

2-2: Title change looks good.

Renaming to “Display options” aligns with the page content and sidebar entry.


61-67: Verify “Order by” labels match the product UI.

Confirm exact label strings (e.g., “Last updated” vs “Last Updated”; “Recently created” vs “Last Created”) to avoid user confusion.

docs/core-concepts/issues/visualise_filter.mdx (2)

2-2: Retitle to “Work item filters” is on point.

Matches the broadened scope beyond visuals.


100-108: “State Group” terminology: confirm group names.

Text mentions “active/backlog” but the example uses “Started”. Verify the canonical group labels in UI (Backlog, Active/Started, Completed) and align both lines accordingly.

sidebars.ts (1)

80-82: Approve: visualization docs present and verified

Promoting layouts / visualise_filter / display-options under Visualization looks correct — good flattening and sensible order. Verified files: docs/core-concepts/issues/layouts.mdx, docs/core-concepts/issues/visualise_filter.mdx, docs/core-concepts/issues/display-options.mdx.

@danciaclara danciaclara merged commit 7e50b5d into master Sep 19, 2025
2 of 3 checks passed
@danciaclara danciaclara deleted the rich-filters branch September 19, 2025 06:54
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.

4 participants