My Review of JetBrains’ Writerside ✅ or ❎ ?

Alright folks, let’s dive into the latest concoction from the JetBrains‘ lab – Writerside. This isn’t just another tool; it’s a game-changer in the technical writing arena. Buckle up as we take a tour of this nifty piece of tech wizardry.

The Gist of Writerside

Melding Code and Prose

JetBrains has pulled a rabbit out of their hat with Writerside, built on the IntelliJ platform. It’s like they’ve read the minds of developers and writers, blending their worlds seamlessly. Imagine crafting documentation right in the heart of your IDE – that’s Writerside for you!

Markdown Meets XML

Here’s where it gets spicy. Writerside juggles Markdown and a custom XML-based markup. It’s like having the best of both worlds, letting you switch hats between a Markdown maverick and an XML expert. This duality is a boon for those who want to add a bit more oomph to their docs.

Testing and Styling with Ease

Over 100 built-in tests? Check. Predefined designs that you can tweak? Double-check. Writerside isn’t just about writing; it’s about making sure your documentation is as robust as your code. No more fretting over broken links or layout hassles.

Real-Time Preview and AI Smarts

The live preview feature is like having a co-pilot, instantly showing you the impact of your edits and flagging errors on the fly. And the AI-based spellchecker and grammar tool? That’s the cherry on top, supporting a plethora of languages and keeping your prose polished.

A screen shot of the markdown and side by side preview.

User Reactions and Real-World Use

First Impressions and Reddit Buzz

The crowd on Reddit is already giving Writerside thumbs up. The Markdown love and VCS integration are big hits. It’s like Writerside is the new cool kid on the block that everyone wants to hang out with.

Collaboration is Key

Writerside is all about tearing down walls between developers and writers. Its “doc as code” approach is like a bridge over troubled waters, aligning documentation with the dev process. It’s not just a tool; it’s a unifier.

Customizable and Accessible

Whether you’re a plugin person or a standalone aficionado, Writerside has got you covered. And the customization options? They let you tailor the experience to your liking, ensuring your docs don’t just sound good but also look the part.

Wrapping Up

In my meager experience with Writerside so far, this is not just another tool; it’s more of a massive shift in technical writing. It’s like they’ve taken the essence of coding and writing, mixed it in a blender, and served up a cocktail of productivity. For teams where code and prose coexist, Writerside is a no-brainer. It’s not just about making documentation; it’s about making it smart, seamless, and collaborative. Exactly what documentation writing needs to and ought to have as key elements of its workflow.

Shoutouts and References