You can now resolve editing conflicts in GitBook!

Nicolas Gaborit
Aug 30, 2018 · 2 min read

We’re dedicating this to all of you who are collaborating intensely on your documentation. We are pleased to announce that GitBook will now let you resolve all editing conflicts neatly. You can be relieved from the fear of losing changes whenever you and your peer change the same piece of content.

Conflicts happen

GitBook embraces an asynchronous workflow for writing documentation. We believe this workflow gives you the best control and let you organize your teamwork tidily. Having the best level of control means you sometimes need to reconcile parallel changes made by different parties. This is called resolving conflicts. Conflicts in GitBook typically happen when two people edit the same draft, or when someone tries to publish a draft after the published version was edited.

So far, GitBook was doing its best to handle conflicts automatically, but at some point it had to make compromises. This resulted in some changes being ignored sometimes. The changes were saved to the revision history, but would not make it to the published version, and you had to redo these changes manually, which is irritating.

Introducing GitBook’s conflict resolution workflow

Starting today, if you try to save or publish a draft, and the changes you made conflicts with changes made by others, you will be asked to resolve those conflicts. Resolving conflicts means integrating your individual changes with the ones made by others. Only the places that present a conflict have to be dealt with. All you have to do is to pick one version or the other, and sometimes merge pieces of text together.

Pick and merge changes in a breeze 💨

In most cases, the number of conflicts will be low and this should be an easy task, so no worry! Once all conflicts are resolved, you’re free to go and publish the final version.

All conflicts solved 🙌Feels good!

We know conflicts in GitBook were a great source of frustration for a lot of you, so we really hope this new feature will fill you with joy.

Now get pumped up and ready to scare all them conflicts away!

Feel free to ping us at if you have any feedback. 👋


GitBook's blog

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store