Skip to content

docs(marketing): sharpen performance changelog copy - #5809

Merged
Kitenite merged 6 commits into
mainfrom
improve-changelog-entry
Jul 20, 2026
Merged

Kitenite merged 6 commits into
mainfrom
improve-changelog-entry

Conversation

@Kitenite

@Kitenite Kitenite commented Jul 20, 2026 •

Copy link
Copy Markdown
Member

Two focused edits to the 2026-07-19 performance changelog entry.

Opening line

Turned the flat intro into a tricolon that maps to the three sections:

We spent the week on performance: reducing memory consumption, smoothing out git hitches, and cutting background CPU.

Also softened "a real before/after measurement" → "a measured before/after".

Browser-tab note

"Get the same treatment" was ambiguous right after two "never touched" sentences (read like tabs were protected, when they're actually offloaded). Now explicit:

Hidden in-app browser tabs are offloaded the same way, and rebuilt when you switch back.

No structural or data changes; tables and numbers untouched.


Summary by cubic

Tightened the 2026-07-19 performance changelog for clarity.

Aligned the opener to the three sections, softened measurement wording, nested TL;DR metrics, clarified that hidden in‑app browser tabs are offloaded and rebuilt, and rewrote the closing note in Kiet’s voice to emphasize ongoing performance work; no tables or numbers changed.

Written for commit 372d7e1. Summary will update on new commits.

Review in cubic

Summary by CodeRabbit

  • Documentation
    • Updated the changelog introduction and TL;DR to highlight three performance improvements: lower memory usage, smoother Git hitches, and reduced background CPU.
    • Revised the measurement wording to “measured before/after” and refreshed the before/after presentation for clarity.
    • Clarified that hidden in-app browser tabs are offloaded and rebuilt when you switch back.
    • Added a closing “More to come” section indicating the work is ongoing.

@coderabbitai

coderabbitai Bot commented Jul 20, 2026 •

Copy link
Copy Markdown
Contributor

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

The changelog entry identifies three performance focus areas, clarifies measurement wording and hidden-tab lifecycle behavior, and adds a note that performance work is ongoing.

Changes

Performance changelog

Layer / File(s) Summary
Clarify performance claims and tab lifecycle
apps/marketing/content/changelog/2026-07-19-performance-memory-and-load.mdx
The entry identifies memory, git hitch, and background CPU improvements, clarifies before/after measurements, explains that hidden tabs are offloaded and rebuilt when revisited, and adds a “More to come” section.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly matches the change: marketing docs copy edits to the performance changelog entry.
Description check ✅ Passed The description covers what changed and why, but it omits the required testing and checklist sections from the template.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch improve-changelog-entry

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.

@greptile-apps

greptile-apps Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR makes two targeted copy edits to the 2026-07-19 performance changelog entry — no structural, data, or table changes are made.

  • The flat opening sentence is expanded into a tricolon that previews the three sections ("reducing memory consumption, smoothing out git hitches, and cutting background CPU"), accurately mapping to the three H2 headings in the document.
  • The browser-tab sentence is rewritten for clarity: "Hidden in-app browser tabs are offloaded the same way, and rebuilt when you switch back" replaces the ambiguous "get the same treatment" phrasing that followed two "never touched" sentences.

Confidence Score: 5/5

Docs-only copy edits with no structural, data, or metric changes — safe to merge.

Both edits are accurate against the document's own content: the tricolon correctly names the three H2 sections, and the browser-tab rewrite faithfully restates the offload-and-rebuild behavior already described for terminals. No numbers, tables, or feature descriptions are touched.

No files require special attention.

Important Files Changed

Filename Overview
apps/marketing/content/changelog/2026-07-19-performance-memory-and-load.mdx Pure prose copy edits: expanded opening sentence into a tricolon and clarified the browser-tab offloading sentence; tables and metrics untouched.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["Performance Changelog Entry\n(2026-07-19)"] --> B["Opening tricolon\n(maps to 3 sections)"]
    B --> C["§1 Lower Memory\n(terminals offloaded to disk)"]
    B --> D["§2 Smoother Git\n(git work on background pool)"]
    B --> E["§3 Quieter CPU\n(port detection one shared scan)"]
    C --> C1["Active terminals → never touched\nTUIs → never touched\nBrowser tabs → offloaded + rebuilt on switch"]
Loading
%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A["Performance Changelog Entry\n(2026-07-19)"] --> B["Opening tricolon\n(maps to 3 sections)"]
    B --> C["§1 Lower Memory\n(terminals offloaded to disk)"]
    B --> D["§2 Smoother Git\n(git work on background pool)"]
    B --> E["§3 Quieter CPU\n(port detection one shared scan)"]
    C --> C1["Active terminals → never touched\nTUIs → never touched\nBrowser tabs → offloaded + rebuilt on switch"]
Loading

Reviews (1): Last reviewed commit: "docs(marketing): sharpen performance cha..." | Re-trigger Greptile

@github-actions

github-actions Bot commented Jul 20, 2026 •

Copy link
Copy Markdown
Contributor

🚀 Preview Deployment

🔗 Preview Links

Service Status Link
Neon Database (Neon) ✅ View Branch
Vercel API (Vercel) ✅ Open Preview
Vercel Web (Vercel) ✅ Open Preview
Vercel Marketing (Vercel) ✅ Open Preview
Vercel Admin (Vercel) ✅ Open Preview
Vercel Docs (Vercel) ✅ Open Preview

Preview updates automatically with new commits

@coderabbitai coderabbitai Bot 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.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/marketing/content/changelog/2026-07-19-performance-memory-and-load.mdx`:
- Line 18: Update the changelog bullet text to use the qualified wording “Less
hitching from Git” and state that switching branches or changing many files
“stutters much less,” without claiming Git hitching is eliminated.
🪄 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: defaults

Review profile: CHILL

Plan: Pro

Run ID: 65507475-6b13-4ba2-b728-52dbe28b7e3d

📥 Commits

Reviewing files that changed from the base of the PR and between d8ec71c and 1f6843a.

📒 Files selected for processing (1)
  • apps/marketing/content/changelog/2026-07-19-performance-memory-and-load.mdx

- JS heap 581 → 286 MB (−51%)
- 4× fewer GPU contexts

- **No more hitching from git.** Switching branches or changing lots of files at once no longer stutters the app.

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.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Avoid claiming that Git hitching is eliminated.

The adjacent metrics still show a 28.0 ms worst-case UI-thread stall, so “no longer stutters” overstates the measured result. Use “Less hitching from Git” and “stutters much less” instead.

🧰 Tools
🪛 LanguageTool

[style] ~18-~18: Consider using a synonym to be more concise.
Context: ...m git.** Switching branches or changing lots of files at once no longer stutters the ap...

(A_LOT_OF)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/marketing/content/changelog/2026-07-19-performance-memory-and-load.mdx`
at line 18, Update the changelog bullet text to use the qualified wording “Less
hitching from Git” and state that switching branches or changing many files
“stutters much less,” without claiming Git hitching is eliminated.

@Kitenite
Kitenite merged commit 11277f9 into main Jul 20, 2026
17 of 18 checks passed

This branch was previously deployed

1 inactive deployment
preview — 372d7e16 Deployed Jul 20, 2026 by Kitenite via Deploy Web #6700
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