We are JetBrains partners

The Good Docs Project  — Many team members contributed to posts from this author.
Sep 19, 2024, updated Sep 12, 2024 857 words

The Good Docs Project is thrilled to announce an exciting new partnership with JetBrains, a leader in building exceptional developer experiences. Joining forces with JetBrains will supercharge our mission to empower developers and tech writers to create better software documentation.

Our collaboration with JetBrains is a pivotal moment for The Good Docs Project, opening up new opportunities to enhance the way developers and technical writers work with documentation.

You can now get The Good Docs Project templates in JetBrains Writerside

Starting with the September 2024 release, the JetBrains Writerside IDE will now include The Good Docs Project templates out-of-the-box, right alongside the default JetBrains templates. This means you can use Writerside to easily load one of The Good Docs Project templates and start writing great documentation immediately.

For those unfamiliar with Writerside, JetBrains launched Writerside in 2023 as part of a strategic effort to improve tools at every stage of the software development process, including writing documentation, testing, and code analysis. Writerside provides a writing environment with all the features of a modern editor: live previews, syntax highlighting, intention actions, filters, reusable snippets, and more. These features enable developers and writers to create high-quality technical documentation using a docs-as-code, DevOps-friendly workflow.

Best of all, the Writerside IDE is free to try and use, making it accessible to everyone looking to streamline their technical documentation process. From the official Writerside product page:

Writerside is now being distributed as an Early Access Program and is completely free.

Even after Writerside’s release, we’re going to have a free version or an ongoing EAP program, so you can continue using the tool for free.

If you’d like to try out our templates in a simple, elegant code editing environment, consider downloading Writerside today.

How JetBrains has already benefitted The Good Docs Project

Since JetBrains first approached us about the Writerside project a few months ago, we’ve already seen significant benefits from our collaboration. Through close work with the JetBrains developers, we realized our templates needed further standardization to enhance usability and make them easier to consume downstream.

In response, our Tech Team recently launched a major template standardization initiative:

  • We standardized the filenames for our template deliverables, ensuring consistency across the entire suite of templates.

  • We ran all the templates through a Markdown linter, cleaning up and optimizing our Markdown files.

  • We checked all our template links to make sure they resolved correctly.

  • We introduced improvements to our merge request review process to ensure we don’t experience any additional filename and Markdown quality drift.

Looking ahead, we’re laying the groundwork for future improvements that will make our templates even more compatible with Writerside. We’re excited about our ongoing collaboration with JetBrains, which will help make our templates even more user-friendly and effective.

JetBrains has a strong commitment to open source

When asked to comment on our partnership, Hadi Hariri from JetBrains said:

JetBrains has always supported the open source movement. We’re excited to see our new tool, Writerside, collaborate with The Good Docs Project to enhance the quality of technical documentation.

— Hadi Hariri
Department Lead of JetBrains Open Source Ecosystem

One of the key reasons we’re excited about partnering with JetBrains is because of their deep commitment to open source. JetBrains not only creates and contributes to numerous open source projects, but they also provide their tools free of charge to open source developers.

What we value most is how JetBrains actively encourages and supports their employees in making meaningful contributions to open source projects. In fact, this is how our relationship with JetBrains first began. JetBrains employees Svetlana Novikova and Alina Terekhova are long-time contributors to our project. Svetlana also serves as a member of our project steering committee and as a lead for our UX and Outreach working group. We deeply appreciate companies like JetBrains that foster a culture of open source contribution. Their support, combined with the talent and camaraderie of their team, has made a lasting impact on our project.

What the JetBrains partnership means for us

We’re thrilled with how Writerside has simplified and streamlined the process of using The Good Docs Project templates. Now, anyone can quickly access and use our templates directly within a code editor, right out of the box.

Before Writerside, the only way to use our templates was to manually copy and paste files or fork them into a new repository---an approach that was neither easy nor scalable. But with Writerside, users can now start working with our templates in a sophisticated code editing environment in just a few clicks.

Because it will be so much easier to use our templates, we believe this will extend our project’s reach by making our templates accessible to a broader audience. As more people adopt them, we’ll benefit from valuable user feedback that will allow us to continuously improve and refine our templates.

With ongoing input from the Writerside user and developer community, we’re confident our templates will evolve to become the standard for writing a wide range of documentation content.

Final thoughts

We are happy to join with JetBrains to provide developers and writers with the tools they need to create outstanding documentation. We’re eager to help Writerside users overcome writer’s block and start producing high-quality, user-friendly documentation using our expertly crafted templates and guides.

Download Writerside today and share your feedback with us!


Image of The Good Docs Project
Please see The Good Docs Project website (https://thegooddocsproject.dev) for more information.

Continue Reading