Skip to content

Docs site improvements: getting started, chaining operations, and UX enhancements#112

Merged
CallumMcMahon merged 12 commits intomainfrom
docs/fix-autonomous-agents-section
Feb 9, 2026
Merged

Docs site improvements: getting started, chaining operations, and UX enhancements#112
CallumMcMahon merged 12 commits intomainfrom
docs/fix-autonomous-agents-section

Conversation

@CallumMcMahon
Copy link
Member

Summary

  • Landing page: Fix autonomous agents section with proper links and Python version warnings
  • Getting Started page: New page covering installation, sessions, async operations, and crash recovery
  • Chaining Operations page: Interactive 5-step workflow tutorial with arrow-shaped tabs, SVG diagrams, and practical examples
  • Code blocks: Add copy button to all code blocks (works for both MDX and markdown)
  • Sidebar: Reorder to Getting Started → API Reference → Guides → Case Studies

Chaining Operations highlights

  • Arrow-shaped stepper tabs using brand colors (#4d4fc4, #cfcfff, #0f125b)
  • Before/after SVG diagrams for each operation
  • Whimsical "wizard rescuing magical creatures" example that maps to real analyst workflows
  • Common workflows section with 5 practical 2-3 operation chains

Test plan

  • Verify all pages render correctly at /getting-started, /chaining-operations, /installation
  • Test copy button on code blocks (both MDX and markdown pages)
  • Click through all 5 tabs in chaining operations, verify pulse animation on next tab
  • Check sidebar order matches expected hierarchy

🤖 Generated with Claude Code

CallumMcMahon and others added 12 commits February 6, 2026 17:49
- Convert plain text to proper ordered/unordered lists
- Add working links to installation and API reference pages
- Add CSS styles for lists in the quickstart section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Basic example
- Sessions: what they are, dashboard visibility, explicit sessions
- Getting session URLs for monitoring
- Async operations with _async variants
- Crash recovery with fetch_task_data

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- ChainedOpsTabs component with 5 arrow-shaped tabs
- CSS using clip-path for chevron/arrow effect
- Placeholder content for each step

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Larger/bolder text for active tab
- Subtle scale-up on hover for inactive tabs
- Pulse animation on next tab after switching (draws eye forward)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Avoids confusion with the 'Getting Started' page having the same name as its parent section.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The sidebar section is named "Overview" to avoid redundancy with the
"Getting Started" page, but the landing page card should still display
"Getting Started" as the user-facing title.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Comment on lines +29 to +31
button.addEventListener("click", async () => {
const code = pre.textContent || "";
await navigator.clipboard.writeText(code);
Copy link

Choose a reason for hiding this comment

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

Bug: The call to navigator.clipboard.writeText() lacks error handling, which can lead to an unhandled promise rejection and misleading UI feedback if the copy operation fails.
Severity: MEDIUM

Suggested Fix

Wrap the await navigator.clipboard.writeText(text) call in a try-catch block. The catch block should handle the potential rejection gracefully, for instance by reverting the button icon to its original state to provide accurate user feedback.

Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent.
Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not
valid.

Location: docs-site/src/components/CodeBlockEnhancer.tsx#L29-L31

Potential issue: The `navigator.clipboard.writeText()` call is not wrapped in error
handling. If the clipboard API call fails, such as when a user denies permission, it
will cause an unhandled promise rejection. While this will not crash the application,
the UI will incorrectly display a success checkmark even on failure, providing
misleading feedback to the user. The unhandled rejection may also be logged to
configured analytics services.

Did we get this right? 👍 / 👎 to inform future reviews.

@dschwarz26 dschwarz26 self-requested a review February 8, 2026 23:27
Copy link
Contributor

@dschwarz26 dschwarz26 left a comment

Choose a reason for hiding this comment

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

While we're here, can we copy over the font contentions from the delphos repo, and get the jetbrains-mono font (and lowercase "everyrow" in the top left) that we see at the top of everyrow.io?

@CallumMcMahon CallumMcMahon requested a review from hnykda February 9, 2026 08:32
@CallumMcMahon
Copy link
Member Author

I've added a ticket to track the remaining stuff mentioned above

@CallumMcMahon CallumMcMahon merged commit 71ddee9 into main Feb 9, 2026
2 checks passed
@CallumMcMahon CallumMcMahon deleted the docs/fix-autonomous-agents-section branch February 9, 2026 12:11
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.

3 participants