Skip to content

Appwrite Arena announcement + documentation#2805

Merged
atharvadeosthale merged 6 commits intomainfrom
arena
Mar 17, 2026
Merged

Appwrite Arena announcement + documentation#2805
atharvadeosthale merged 6 commits intomainfrom
arena

Conversation

@atharvadeosthale
Copy link
Member

@atharvadeosthale atharvadeosthale commented Mar 16, 2026

This PR adds Appwrite Arena to documentation and adds an announcement blog.

Summary by CodeRabbit

  • New Features

    • Added Appwrite Arena: new blog post, documentation pages, and sidebar navigation.
  • Chores

    • Reorganized icon library: renamed and remapped many icon identifiers and updated public CSS/SCSS icon selectors and types.
    • Added a new icon asset referenced in the build cache.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 16, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7e700aa0-d8b4-4467-8ce2-e9a98c5b5147

📥 Commits

Reviewing files that changed from the base of the PR and between 52a015d and 6347bab.

📒 Files selected for processing (1)
  • src/routes/blog/post/announcing-appwrite-arena/+page.markdoc
🚧 Files skipped from review as they are similar to previous changes (1)
  • src/routes/blog/post/announcing-appwrite-arena/+page.markdoc

Walkthrough

Replaces and remaps the project icon set across multiple outputs: SCSS variables, generated CSS/SCSS selectors, and the icons info.json — many icon identifiers are renamed and reassigned to different glyph codepoints; a new mcp icon is added. The TypeScript IconType union is updated to match the new icon names. Additionally, an Appwrite Arena blog post and documentation pages (layout and tooling page) are added, a Sidebar navigation item for Arena is inserted, and an image asset entry is added to the optimize cache.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Appwrite Arena announcement + documentation' accurately reflects the primary changes: adding announcement blog post and documentation for Appwrite Arena.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch arena
📝 Coding Plan
  • Generate coding plan for human review comments

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)
src/routes/docs/tooling/arena/+page.markdoc (1)

15-16: Keep the docs page versionless.

The 191 / 165 / 26 counts will stale as soon as Arena adds or rebalances questions. Since this lives under /docs, I'd keep the dated numbers in the announcement post and make this page evergreen.

♻️ Suggested wording
-Arena evaluates each model using a pool of **191 questions** spanning **9 Appwrite service categories**:
+Arena evaluates each model using a pool of questions spanning Appwrite service categories such as:

-165 multiple-choice questions with a single correct answer. These scores are fully reproducible with no judge bias, providing a reliable baseline for comparison across models.
+Multiple-choice questions with a single correct answer. These scores are fully reproducible with no judge bias, providing a reliable baseline for comparison across models.

-26 open-ended questions scored from 0 to 1 by an AI judge using rubrics and reference answers. These questions test reasoning and real-world usage patterns that cannot be captured by multiple-choice alone. Scores may have slight variance due to the nature of AI-based evaluation.
+Open-ended questions scored from 0 to 1 by an AI judge using rubrics and reference answers. These questions test reasoning and real-world usage patterns that cannot be captured by multiple-choice alone. Scores may have slight variance due to the nature of AI-based evaluation.

Also applies to: 40-44

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

In `@src/routes/docs/tooling/arena/`+page.markdoc around lines 15 - 16, Remove
hard-coded numeric counts from the docs page line containing "Arena evaluates
each model using a pool of **191 questions** spanning **9 Appwrite service
categories**" (and the other occurrences of 191 / 165 / 26) and replace them
with versionless wording such as "a pool of questions across multiple Appwrite
service categories" or "a regularly updated pool of questions spanning Appwrite
service categories" so the page remains evergreen; locate these exact phrases in
+page.markdoc and update the copy accordingly.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@src/icons/output/web-icon.css`:
- Around line 23-223: The stylesheet is missing a centralized .web-icon-button
utility causing inconsistent styles where components (e.g., usages alongside
.web-icon-search, .web-icon-chevron-down, etc.) currently rely on local
component CSS; add a single .web-icon-button rule to web-icon.css that defines
the shared button container styles (display, size, alignment, cursor,
background/hover states, and accessible focus outline) so all components using
the .web-icon-button class get consistent appearance and behavior; ensure the
selector targets .web-icon-button and nested .web-icon-* pseudo elements
(before) so the icon glyphs render correctly and test in components like
MainFooter and changelog to confirm no local overrides are still required.

---

Nitpick comments:
In `@src/routes/docs/tooling/arena/`+page.markdoc:
- Around line 15-16: Remove hard-coded numeric counts from the docs page line
containing "Arena evaluates each model using a pool of **191 questions**
spanning **9 Appwrite service categories**" (and the other occurrences of 191 /
165 / 26) and replace them with versionless wording such as "a pool of questions
across multiple Appwrite service categories" or "a regularly updated pool of
questions spanning Appwrite service categories" so the page remains evergreen;
locate these exact phrases in +page.markdoc and update the copy accordingly.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: c8f9109c-fe52-4375-8842-68c2c5f1779b

📥 Commits

Reviewing files that changed from the base of the PR and between 1f85115 and 75da532.

⛔ Files ignored due to path filters (8)
  • src/icons/optimized/arena.svg is excluded by !**/*.svg
  • src/icons/output/web-icon.eot is excluded by !**/*.eot
  • src/icons/output/web-icon.svg is excluded by !**/*.svg
  • src/icons/output/web-icon.symbol.svg is excluded by !**/*.svg
  • src/icons/output/web-icon.ttf is excluded by !**/*.ttf
  • src/icons/output/web-icon.woff is excluded by !**/*.woff
  • src/icons/output/web-icon.woff2 is excluded by !**/*.woff2
  • src/icons/svg/arena.svg is excluded by !**/*.svg
📒 Files selected for processing (10)
  • src/icons/output/_variables.scss
  • src/icons/output/info.json
  • src/icons/output/web-icon.css
  • src/icons/output/web-icon.scss
  • src/lib/components/ui/icon/sprite/sprite.svelte
  • src/lib/components/ui/icon/types.ts
  • src/routes/blog/post/announcing-appwrite-arena/+page.markdoc
  • src/routes/docs/Sidebar.svelte
  • src/routes/docs/tooling/arena/+layout.svelte
  • src/routes/docs/tooling/arena/+page.markdoc

Copy link
Contributor

Choose a reason for hiding this comment

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

Hmm, if those are swords, they are missing handle. Was this AI made, or imported from some icon doc? Might be worth checking with design team

Copy link
Member Author

Choose a reason for hiding this comment

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

This was AI generated, in the past (esp. for skills) design team had advised me to use AI to generate these, as these are temporarily placed on the main docs page and will be shifted to AI section of docs soon!


165 multiple-choice questions with a single correct answer. These scores are fully reproducible with no judge bias, giving you a reliable baseline for comparing models.

## AI-judged (open-ended)
Copy link
Contributor

Choose a reason for hiding this comment

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

Might be worth mentioning if they prefer not to see AI-judged questions as part of benchmark, it can easily be toggled off under "Scoring" filter

Each model is tested in two contexts:

- **Without Skills**: The model answers using only its built-in training data.
- **With Skills**: The model answers with access to Appwrite's [Skills files](/docs/tooling/skills), which provide up-to-date SDK and API context.
Copy link
Contributor

Choose a reason for hiding this comment

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

Not sure if relevant or too technical; We provide skills as two tools - TypeScript, and CLI. System prompt incldues mention if their availability, and we do not require for AI to utilize them, if it doesnt want to.

Current benchmark also only tests JavaScript, with other languages coming on the future.

Copy link
Member Author

Choose a reason for hiding this comment

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

I think it would make it a bit hard to understand tbh

@atharvadeosthale atharvadeosthale merged commit aa2763a into main Mar 17, 2026
10 of 11 checks passed
@atharvadeosthale atharvadeosthale deleted the arena branch March 17, 2026 12:52
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