Skip to content

Add a dedicated Redis Iris docs space with its own nav and dark theme - #4215

Merged
mich-elle-luna merged 5 commits into
mainfrom
iris-nav
Oct 6, 2026
Merged

mich-elle-luna merged 5 commits into
mainfrom
iris-nav

Conversation

@mich-elle-luna

@mich-elle-luna mich-elle-luna commented Oct 6, 2026 •

Copy link
Copy Markdown
Collaborator
  • Header: replace the "AI agent builder" button with "Redis Iris", linking to the Iris landing page (desktop and mobile menus).
  • Sidebar: on pages under develop/ai/context-engine or operate/iris, show only the Iris pages, grouped as GET STARTED and DEPLOY & OPERATE, with a link back to all documentation.
  • Theme: Iris pages get a scoped dark stylesheet (static/css/iris-dark.css) covering the content area and sidebar; header, footer, and search are unchanged.
  • Move the Iris interactive demo under Concepts, after Request flow, with an alias from the old URL.
  • Reorder services: Agent Memory, Context Retriever, LangCache, Data Integration.

Note

Low Risk
Documentation site navigation, Hugo templates, and scoped CSS only; no runtime product or security logic changes.

Overview
Introduces a Redis Iris docs experience for pages under develop/ai/context-engine and operate/iris, detected via a new is-iris-page.html partial.

Navigation and discovery: The site header (desktop and mobile) now promotes Redis Iris and links to the context-engine landing instead of AI agent builder. On Iris pages, the sidebar switches to an Iris-only tree with GET STARTED (develop) and DEPLOY & OPERATE (operate), plus a link back to all documentation; category badges are hidden on those operate layouts. The home page bottom-left tile now points at AI agent builder instead of JSON.

Dark theme: Iris pages load iris-dark.css and add an iris-dark body class, restyling main content, sidebar, prose, demos (.rcr / .iris), context-map widgets, and related UI while leaving header, footer, and search unchanged.

Content IA: Service section weights are reordered (Agent Memory, Context Retriever, LangCache). The Iris interactive demo page gets weight 10 and an alias from the old interactive-demo URL. Mermaid SVG exports drop baked-in white backgrounds so CSS can invert diagrams on dark pages.

Reviewed by Cursor Bugbot for commit eb3d6c1. Bugbot is set up for automated code reviews on this repo. Configure here.

- Header: replace the "AI agent builder" button with "Redis Iris", linking
  to the Iris landing page (desktop and mobile menus).
- Sidebar: on pages under develop/ai/context-engine or operate/iris, show
  only the Iris pages, grouped as GET STARTED and DEPLOY & OPERATE, with a
  link back to all documentation.
- Theme: Iris pages get a scoped dark stylesheet (static/css/iris-dark.css)
  covering the content area and sidebar; header, footer, and search are
  unchanged.
- Move the Iris interactive demo under Concepts, after Request flow, with an
  alias from the old URL.
- Reorder services: Agent Memory, Context Retriever, LangCache, Data
  Integration.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

🧠 Redis Memory

Found 9 related items from repository history:

Memory updated at eb3d6c1

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Stale Bugbot comment from a previous run.

Comment thread static/css/iris-dark.css
Comment thread layouts/partials/docs-nav.html
@mich-elle-luna
mich-elle-luna requested a review from a team October 6, 2026 04:35
@paoloredis

Copy link
Copy Markdown
Collaborator

The interactive demos need to be updated to have a similar dark theme as well

@andy-stark-redis andy-stark-redis left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks good. One thing to note: the diagram on the main Concepts page has a white background but the interactive request flow diagram has a black background now. I don't know if it's important to have consistency with this or not but I thought I'd mention it.

@mich-elle-luna

Copy link
Copy Markdown
Collaborator Author

thanks @paoloredis and @andy-stark-redis I will work on this more and see how far I get with the dark theme before I abandon it.

Dark theme (static/css/iris-dark.css):
- Callouts (note, tip, info, warning shortcodes and > [!NOTE] blockquotes)
  had a light gray background under light text; give them a dark surface.
- List markers: index.css colors ::marker directly, so the prose variables
  never reached bullets and step numbers.
- Multitabs, the active "On this page" entry, and sidebar child-link hover
  were hard-coded to light backgrounds or dark ink.
- Tile card icons and concept diagrams are dark-on-light art; invert them
  and rotate the hue back so red accents stay red. The diagram rule skips
  iris-diagram/, the interactive demo's own artwork.
- Round the corners of screenshots, matching the rounded-lg some pages set.
- Service demos: swap the shared .rcr tokens and cover their hard-coded
  whites and syntax colors. The overview demo is .rcr too, so its pastel
  highlight chips and reply parts keep dark text.
- Download dialog and feedback textarea kept light native backgrounds; set
  color-scheme: dark and give both dark surfaces. The "Copied!" tooltip
  keeps its light bubble and gets its dark text back.

Nav and layouts:
- Offline bundles: wrap the back link and each Iris nav group in list items
  so prune_sidebar drops the half that is not in the bundle. The halves ship
  in different bundles, so data-offline-hide cannot mark either one.
- Operate layouts skip the category badge on Iris pages; frontmatter
  categories are unchanged.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit ac144be. Configure here.

Comment thread static/css/iris-dark.css
Comment thread static/css/iris-dark.css
- On this page links and the meta links (Edit this page, Create an issue)
  kept the colors index.css compiles in, #5C707A and #4C4C4C, which sit at
  about 3.5:1 and 2:1 on the dark background. Use the theme's muted gray,
  and darken the bright TOC track bar to the border color.
- Rate this page: an empty star is a white fill with a gray outline, so on
  a dark page every star looked filled and selected stars looked dimmer.
  Make empty stars hollow and selected stars light; hover stays red.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@dwdougherty

Copy link
Copy Markdown
Collaborator

Looking really good. A couple of nits: first, the following diagrams don't match the others:

  1. The context-map on context-engine/concepts/request-flow/_index.md and the cards it reveals when elements are selected;
  2. images/rc/langcache-process.png;

In both cases, the diagram has bright white tiles.

Finally, the RC screenshots should probably be re-done in dark mode; the contrast is fairly jarring.

mich-elle-luna and others added 2 commits October 6, 2026 14:52
- Request flow: give the context-map diagram (nodes, edges, edge labels,
  scenario buttons, description panel) dark styles, and darken the grey
  end of the node border gradient that context-map.js sets as a stop-color.
- Concept diagrams: remove the white background baked into the five
  Mermaid SVG exports, so after the dark theme's invert filter they sit on
  the page instead of on a black panel. They are used only on Iris pages.
- Screenshots of the light console: dim to 90% brightness and add a border
  in the theme's border color; small button crops (36px, 150px) skip the
  border. The concept diagrams are excluded, because this selector outranks
  theirs and its filter would replace their invert.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
The header button that used to open the AI agent builder now opens Redis
Iris, so the builder gets a home page entry point instead: the JSON card in
the Redis for AI and search grid now links to /develop/ai/agent-builder/,
with an outline sparkle icon echoing the old header button. JSON stays
reachable from the Data types sidebar.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@mich-elle-luna
mich-elle-luna merged commit cc78810 into main Oct 6, 2026
99 checks passed
@mich-elle-luna
mich-elle-luna deleted the iris-nav branch October 6, 2026 22:22
EliShteinman added a commit to EliShteinman/docs that referenced this pull request Oct 6, 2026
Adds a dedicated Redis Iris docs space with its own sidebar and dark theme, swaps the header link to Redis Iris, and replaces the home page JSON card with an AI agent builder card.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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