Skip to content

Assorted content updates to Website, README, and Welcome Docs#1590

Draft
anthonyiscoding wants to merge 6 commits intomainfrom
chore/content-updates-2
Draft

Assorted content updates to Website, README, and Welcome Docs#1590
anthonyiscoding wants to merge 6 commits intomainfrom
chore/content-updates-2

Conversation

@anthonyiscoding
Copy link
Copy Markdown
Contributor

@anthonyiscoding anthonyiscoding commented May 1, 2026

Summary by CodeRabbit

  • Documentation

    • Updated README to prioritize worker-centric integration guidance with practical command examples and quickstart references
    • Rewrote homepage with new problem-centric narrative, core primitives overview, execution model tables, and scaling architecture details
  • Style

    • Refined console trace UI with improved header capitalization, button styling, and hover transitions

- Override .xp-trace-actions .continue-link to use filled button style
  matching deploy/send buttons, with correct hover text color
- Remove text-transform:uppercase from .xp-trace .head .label so
  "iii console" renders in correct case
- Add important callout directing users to Quickstart and iii experience
- Clarify the quadratic integration cost explanation
- Add section about pre-built workers and workers.iii.dev
- Remove redundant Examples section (covered by callout)
Rewrites the docs landing page to align with the iii manifesto and
website messaging. Covers the core problem (quadratic integration cost),
the three primitives, execution model, live system traits, and the
agent-native design philosophy.
@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 1, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
iii 🟢 Ready View Preview May 1, 2026, 7:57 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented May 1, 2026

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

Project Deployment Actions Updated (UTC)
iii-website Ready Ready Preview, Comment May 1, 2026 8:27pm

Request Review

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 1, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: b877f7a7-395e-4d09-bf74-d7047bf71317

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/content-updates-2

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.

@anthonyiscoding anthonyiscoding changed the title Chore/content updates 2 Assorted content updates to Website, README, and Welcome Docs May 1, 2026
GitHub requires the alert type on its own line, but Prettier
collapses it. Added ignore comment to preserve formatting.
Copy link
Copy Markdown
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: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Around line 16-19: Fix the typo in the README sentence "If you want an even
shorter introduction the try the simulated [iii experience]..." by removing the
extra "the" and adding the missing comma: change it to "If you want an even
shorter introduction, try the simulated [iii experience]..." so the phrase in
the prominent callout reads correctly.
- Around line 32-35: Replace the incorrect phrase "We also ships workers with
more being added all the time." in the README paragraph with a grammatically
correct version such as "We also ship workers, with more being added all the
time." to fix the subject-verb agreement; update the sentence that begins with
"We also ships workers" so it reads "We also ship workers..." and keep the rest
of the sentence unchanged.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 4d6cfc12-d7fa-4967-bfe6-596e795383d6

📥 Commits

Reviewing files that changed from the base of the PR and between 19a6f7e and 17e29cc.

📒 Files selected for processing (3)
  • README.md
  • docs/index.mdx
  • website/index.html

Comment thread README.md
Comment on lines +16 to +19
> The best way to understand iii is to
> [try our Quickstart](https://iii.dev/docs/quickstart), it will take just two minutes and may
> forever change how you build software. If you want an even shorter introduction the try the
> simulated [iii experience](https://iii.dev/#experience).
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.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Fix typo in the IMPORTANT callout sentence.

Line 18 has “the try the”, which reads as a typo and breaks flow in the most prominent block.

Suggested edit
-> forever change how you build software. If you want an even shorter introduction the try the
+> forever change how you build software. If you want an even shorter introduction, try the
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
> The best way to understand iii is to
> [try our Quickstart](https://iii.dev/docs/quickstart), it will take just two minutes and may
> forever change how you build software. If you want an even shorter introduction the try the
> simulated [iii experience](https://iii.dev/#experience).
> The best way to understand iii is to
> [try our Quickstart](https://iii.dev/docs/quickstart), it will take just two minutes and may
> forever change how you build software. If you want an even shorter introduction, try the
> simulated [iii experience](https://iii.dev/#experience).
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 16 - 19, Fix the typo in the README sentence "If you
want an even shorter introduction the try the simulated [iii experience]..." by
removing the extra "the" and adding the missing comma: change it to "If you want
an even shorter introduction, try the simulated [iii experience]..." so the
phrase in the prominent callout reads correctly.

Comment thread README.md
Comment on lines +32 to +35
We also ships workers with more being added all the time. You can browse our worker repository at
[workers.iii.dev](https://workers.iii.dev/). Adding any of them to a system is as easy as installing
a library or package and can be done with the command `iii worker add iii-sandbox`, or `iii-queue`,
or `iii-stream`. New infrastructure-level and service-level workers are being added all of the time.
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.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Correct subject-verb agreement in worker repository paragraph.

Line 32 uses “We also ships workers”, which is grammatically incorrect in user-facing docs.

Suggested edit
-We also ships workers with more being added all the time. You can browse our worker repository at
+We also ship workers, with more being added all the time. You can browse our worker repository at
🧰 Tools
🪛 LanguageTool

[style] ~35-~35: Consider removing “of” to be more concise
Context: ...d service-level workers are being added all of the time. The structure of workers enables...

(ALL_OF_THE)

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

In `@README.md` around lines 32 - 35, Replace the incorrect phrase "We also ships
workers with more being added all the time." in the README paragraph with a
grammatically correct version such as "We also ship workers, with more being
added all the time." to fix the subject-verb agreement; update the sentence that
begins with "We also ships workers" so it reads "We also ship workers..." and
keep the rest of the sentence unchanged.

Add upstream/downstream friction framing to explain the full scope
of integration problems iii solves.
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.

1 participant