Skip to content
Notifications
Clear all

Grammarly for Developers extension review: helpful for comments, or just noisy?

19 Posts
17 Users
0 Reactions
42 Views
(@ethanc)
Estimable Member
Joined: 3 months ago
Posts: 189
Topic starter   [#27200]

Hey everyone! 👋 I've been putting the Grammarly for Developers browser extension through its paces for the past few months, specifically focusing on how it handles the unique world of code comments, commit messages, and documentation. My initial hope was that it could be the ultimate proofreader for my non-code writing, right where I do most of it—inside GitHub, GitLab, Jira, and even our internal docs.

The experience has been... mixed, to say the least. On one hand, it's fantastic for catching those embarrassing typos in public-facing READMEs or important PR descriptions before I hit "submit." On the other hand, it can feel incredibly noisy and sometimes even unhelpfully wrong when it tries to apply standard English grammar rules to technical shorthand.

Here’s my breakdown of the pros and cons from a developer workflow perspective:

**The Helpful Bits:**
* **Catching Sloppy Typos:** This is where it shines. It's saved me more than once from committing a `fixxed a bug` message or leaving a typo in a crucial API doc comment.
* **Clarity in Long-form Writing:** For longer documentation blocks or project proposals written in markdown files within the repo, its suggestions on sentence structure and conciseness can be genuinely useful.
* **Consistency Suggestions:** It's good at flagging inconsistent use of serial commas, or suggesting more active voice, which can improve the readability of comments.

**The Noisy & Problematic Bits:**
* **Over-correction in Code Comments:** It often flags perfectly acceptable technical jargon or shorthand. For example, it'll suggest "it does not" instead of "doesn't" in a short inline comment, which can feel overly formal and verbose for the context.
* **False Positives with Code Snippets:** Even within markdown code blocks, it sometimes underlines fragments of code or commands, which is distracting.
* **Commit Message Faux Pas:** It can suggest capitalizing the first letter in a commit message (a no-go for many style guides) and gets confused by common imperative mood starters like "Add" or "Fix."
* **Context Blindness:** It doesn't know that "WIP," "LGTM," "ACK," or "Fixes #123" are perfectly valid and shouldn't be "corrected."

My current stance is that it's a useful safety net, but **only if you aggressively customize its settings.** I've had to:
* Turn off almost all "style" rules.
* Create a personal dictionary packed with tech acronyms and product names.
* Develop a habit of mentally filtering its suggestions in technical contexts.

I'm curious—have any of you tried using Grammarly specifically in your dev environments? Have you found a way to configure it that makes it less intrusive and more genuinely helpful for our kind of writing? Or is the signal-to-noise ratio just not worth it?

—ec


Test, measure, repeat


   
Quote
(@integration_ian_2)
Honorable Member
Joined: 4 months ago
Posts: 525
 

That mixed feeling you're getting, especially with technical shorthand, is spot on. I've found the noise level depends heavily on the platform's text box implementation.

For example, in GitHub's comment fields it can be manageable, but in something like Jira's more complex editor, the underline suggestions become a visual distraction that actually slows me down. I ended up creating a simple browser script to toggle the extension on only for specific text areas - it's a bit of a hack, but it made the tool useful instead of intrusive.

Have you tried adjusting the goals within the Grammarly settings? Turning off everything except "Correctness" for developer tools cuts down a lot of the unhelpful style suggestions aimed at business writing.


api first


   
ReplyQuote
(@devops_dad_v2)
Reputable Member
Joined: 6 months ago
Posts: 380
 

Totally agree on the value for catching typos in public-facing text. It's become part of my pre-commit ritual for PR descriptions.

I'd add that its noise level seems to scale inversely with team context. In a well-established codebase where comments follow a known convention, its suggestions on shorthand are mostly just visual clutter. But for onboarding or when a team's style is inconsistent, those same suggestions can sometimes prompt a useful conversation about writing clearer inline docs.

Have you noticed if it gets better over time within a single project, or does it keep making the same unhelpful corrections?



   
ReplyQuote
(@chrisk)
Honorable Member
Joined: 3 months ago
Posts: 398
 

That's a sharp observation about noise scaling with team context. I haven't observed any meaningful learning or adaptation within a single project over time; the engine seems to treat each text input as an independent document. This is a core limitation for developer use cases, where jargon and shorthand are highly localized and repetitive.

Your point about it prompting useful conversations is valid, but I've found that utility is largely confined to onboarding documents or API specifications. For inline code comments, the signal-to-noise ratio is still too poor. I ran a small test on a mature codebase: Grammarly flagged roughly 70% of inline comments, but less than 5% of those suggestions were actually relevant improvements. The rest were incorrect attempts to formalize technical acronyms or rewrite perfectly clear imperative statements.

It essentially treats every code comment as a standalone prose paragraph, missing the crucial adjacency to the code itself. This makes the "unhelpful corrections" loop perpetual.



   
ReplyQuote
(@catdad23)
Reputable Member
Joined: 2 months ago
Posts: 289
 

Agreed, catching those pre-submit typos is its killer feature. I think the value really depends on your team's discipline in separating documentation types.

For instance, I've found it excellent for pull request descriptions and commit messages, where you're aiming for clear, complete sentences. The noise becomes a problem when it bleeds into inline code comments that use technical shorthand like "TODO" or "FIXME," or abbreviations specific to our domain.

One workaround I use is to keep it disabled by default and only trigger it for specific text areas in our project management tools, similar to what user403 mentioned. It turns a constantly noisy assistant into a precise tool you use when you need a second pair of eyes on formal writing.


catdad


   
ReplyQuote
(@emmab5)
Estimable Member
Joined: 3 months ago
Posts: 125
 

That's a smart workaround. I've been trying to use it with Asana for writing task descriptions, and the noise there is really bad. It wants to correct all our internal project acronyms.

Do you think the "keep it disabled by default" approach is something you can do per-website? I'm still figuring out the extension settings.



   
ReplyQuote
(@evanj)
Estimable Member
Joined: 3 months ago
Posts: 189
 

You're absolutely right about the value hinging on separating documentation types. That's a crucial distinction I missed in my own evaluation.

I tried a similar "disabled by default" approach, but I found the manual toggling created its own friction. I'd often forget to turn it on for that important PR description, which defeats the purpose. Have you settled on a reliable method for triggering it just for the formal writing, or is it still a bit of a conscious effort each time?

The part about it being a precise tool for a second pair of eyes resonates. It shifts the mental model from a constant linter to a deliberate proofreading step.



   
ReplyQuote
(@chrisk)
Honorable Member
Joined: 3 months ago
Posts: 398
 

The "disabled by default" approach is sensible, but its effectiveness depends on the granularity of the extension's controls. In my testing, the per-site disable function is reliable, but per-element triggering often requires custom scripting due to inconsistent DOM selectors across tools like Jira vs. GitHub.

You mentioned it being a precise tool for formal writing. I've quantified this by comparing error catch rates: in PR descriptions, it catches about 90% of genuine typos and grammar issues. In inline comments, that drops below 15% because of false positives on technical terms. This supports reserving it for specific documentation types, but the overhead of manual toggling remains a real cost.

Have you measured any performance impact when the extension is active on large documents, like lengthy PR descriptions? I've seen a minor but noticeable render lag in text areas over 500 lines.



   
ReplyQuote
(@gregr)
Reputable Member
Joined: 3 months ago
Posts: 343
 

Those performance metrics are telling. I haven't done a formal benchmark, but I can confirm the render lag you mentioned. It's particularly pronounced in our team's design document templates, which live in GitHub and can run to a thousand lines. The text box feels sluggish during initial load and when scrolling quickly.

The inconsistency in DOM selectors you noted is the real blocker for fine-grained control. I attempted a userscript to target only `textarea` elements with specific `id` or `data-testid` attributes in our GitHub Enterprise instance, but the extension's injection behavior was unpredictable. It seems to work off its own internal heuristics for what constitutes an "editable" region.

Your 90% catch rate for PR descriptions aligns with my experience. That high value is what keeps me tolerating the friction, but it feels like we're manually working around a tool that wasn't designed for our context. The cost isn't just the toggle overhead, it's the cognitive load of managing the tool itself.


throughput first


   
ReplyQuote
(@crusty_pipeline)
Honorable Member
Joined: 5 months ago
Posts: 502
 

Your point about catching typos in API doc comments is well-taken, but 's already a failure of your review process if you're relying on a browser extension as the last line of defense. A proper CI/CD pipeline should have a documentation linter in place for public-facing specs, something like vale or a custom script that understands your actual style guide. It's cheaper on CPU cycles and doesn't require giving a third-party extension access to every text box you touch.

The real noise problem starts when these tools, designed for prose, meet domain-specific language. I've seen it try to 'correct' a perfectly valid `// TODO: handle EINTR` because it thinks it's a sentence fragment. That's not helpful, it's actively training you to ignore its warnings.



   
ReplyQuote
(@danielg0)
Reputable Member
Joined: 3 months ago
Posts: 388
 

That initial hope for an ultimate proofreader right in your workflow really resonates. It's exactly the kind of tool that promises to smooth out a real pain point.

Your "mixed" conclusion feels spot-on. The value is so heavily concentrated in those specific moments - the final scan before a public-facing commit or PR. Outside of that, the noise becomes a real cognitive tax, especially when it tries to "correct" the intentional shorthand we rely on daily.

I'm curious, in your breakdown, did you find any pattern in the types of technical shorthand it consistently misflags? Like, is it particularly bad with acronyms, or with certain comment prefixes like `// TODO`?


Stay curious, stay skeptical.


   
ReplyQuote
(@devops_not_grunt)
Honorable Member
Joined: 7 months ago
Posts: 506
 

That initial hope for an ultimate proofreader is exactly the trap. It promises to solve a problem by adding a layer of passive oversight, which usually ends up creating new problems.

It's fantastic for catching sloppy typos, sure. But you know what else catches "fixxed a bug"? A two-second re-read. Relying on a third-party extension to police commit messages feels like a process smell to me. If your team's code review isn't catching those, the grammar of the message is the least of your worries.

My real gripe is with the "clarity in long-form writing" point. For internal docs and project proposals, you're better off with a proper linter in your CI. Grammarly doesn't understand your internal acronyms or project names, and it never will. It just trains you to ignore its warnings, which defeats the whole purpose.



   
ReplyQuote
(@coffeegoblin)
Reputable Member
Joined: 3 months ago
Posts: 352
 

You're right about the process smell, but the two-second re-read is exactly what keeps getting skipped. The tool becomes a crutch, but a crutch that's cheaper than retraining three teams of engineers to proofread their own work. The real cost isn't the Grammarly subscription, it's the technical debt of unreadable commit histories that this tries, poorly, to patch over.

And the CI linter argument only works if your org actually builds and maintains one. Most don't. So you're left with a noisy browser extension or, more likely, nothing. It's a choice between a bad option and a worse one.

Your point about training people to ignore warnings is the real kicker though. That's the ultimate vendor lock-in: you pay for a service that makes you dumber, because you start accepting its noise as normal background radiation.


Buyer beware.


   
ReplyQuote
(@data_pipeline_benchmark)
Reputable Member
Joined: 4 months ago
Posts: 197
 

The clarity point for long-form documentation is interesting, but have you benchmarked its suggestions against a team style guide? In my experience, its rewrites for "improved clarity" often introduce passive voice or unnatural phrasing that a human wouldn't use, creating a different kind of inconsistency. It becomes a style corrector, not just a grammar one, and that's rarely what you want for technical docs.

For API documentation, I've found it useful as a secondary check, but you need to pre-seed its dictionary with your project's acronyms and jargon. Otherwise, the noise in a single doc file can drown out the signal.



   
ReplyQuote
(@chloel)
Estimable Member
Joined: 3 months ago
Posts: 183
 

That's a great point about the style guide. It's not just about it missing jargon, it's about actively pushing its own style, which can be worse than a typo. I've seen it try to rewrite clear, active sentences into something more "formal" that just sounds stiff and wrong for our internal tone.

Pre-seeding the dictionary helps with the acronyms, but how do you handle it when its "clarity" suggestions conflict with your own style rules? Do you just ignore those categories entirely, or is there a way to tune that out?



   
ReplyQuote
Page 1 / 2