GitBook

How do you define success in docs? How can you prove that docs are a vital part of your product experience? Sure, we all know that great documentation is a crucial part of any product. It doesn’t just support users — it enhances the entire product experience. But success metrics can be hard to define. Which is why we’re excited about the State of Docs report. The aim is to pull together insights from technical writers, product managers, developers, and documentation professionals you to uncover the trends, challenges and best practices across the industry. And —?of course —?to help prove great docs are vital to any great product’s success. Take the survey here: https://buff.ly/zkZk30L We can’t wait to see the results! #Documentation #Docs #StateOfDocs #DocsReport

Now live: new hint styles ? ?? Add optional headers, customize the colors, and more. Read more in our changelog: https://buff.ly/41ypsTn

Great documentation isn’t just a nice-to-have—it’s part of the product. We sat down with Ron Cohen, Co-founder & CTO of Bucket, to hear how GitBook helps them craft seamless, on-brand dev docs that elevate the user experience. Read the full story below!

We’ve been consolidating some of the GitBook UI to make it easier to preview, update, and review the changes you and your team make for your docs. Check out the new header when editing your GitBook content—Now live ?? Find out more: https://buff.ly/4gvCg19

Sphere’s awesome new docs are powered by GitBook ?? Go check them out! #PoweredByGitBook #ProductDocs #KnowledgeBase

We just shipped a HUGE update to site insights ?? You now get data visualization, grouping and filtering, and a ton more information displayed right in the app. Plus, there are new analytics to track clicked links and OpenAPI endpoint tests. You can also filter and group data using a number of new metrics. For example, you could look at search data for a specific site section, or filter your traffic data by country, device, browser and more ?? This is a massive update, and offers tons of new possibilities for your site. We can’t wait to hear what you think. Head to your site dashboard to check it out, or take a look at our changelog to find out more: https://buff.ly/4gC4pUz

? We shipped some big updates to the footer last week! Now, site with more than 4 link groups are auto-organized into a grid, wider logos display larger, and everything aligns perfectly. Live now—head to the changelog for all the details. https://buff.ly/4gC4pUz

Did you know? ?? Open source projects can create documentation in GitBook for free! With our free Sponsored site plan you can even earn funding towards your project —?and we won’t take a cut. Read more and sign up to join hundreds of other projects here:

We just shipped a bunch of improvements to GitBook, including: ? Visual upgrades for docs sites ?? Breadcrumbs for page groups and sub-pages ?? More consistent tables ?? Markdown styling support in comments Get all the details in our changelog:

Reusable content a super easy way to keep your docs updated. Here’s how it works: 1. Select some blocks 2. Turn them into reusable content 3. Add it to other pages in your space 4. Edit the original content to update every instance This is one of our most-requested features, and there are plenty of uses cases: We’ve seen beta testers using synced blocks to build banners advertising a virtual event. They’ve added alerts to tell their users that they’re looking at an older version of the docs, or single line-paragraphs that describe common product features. Some have added beta feature disclaimers at the bottom of certain pages —?and there’s many more options. As we build more tools for managing content at scale, it’s really important to us that we don’t compromise on the values that bring users to GitBook today. So if you’ve built a review workflow around change requests, you’ll still be able to use that same workflow when you create and edit reusable content. Find out more about reusable content — and our other recent announcements — here: https://buff.ly/4i8QYgp