# Document breaking changes better?

**URL:** <https://internals.rust-lang.org/t/document-breaking-changes-better/2791>\
**Category:** Uncategorized\
**Created:** [October 14, 2015, 6:28pm UTC](https://internals.rust-lang.org/t/document-breaking-changes-better/2791 "2015-10-14T18:28:12Z")\
**Posts on this page:** 1\
**Showing post:** 12

<div class="post-metadata">

**Author:** ![brson](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/brson/32/5197_2.png) [@brson](https://internals.rust-lang.org/u/brson)\
**Post date:** [October 18, 2015, 4:52pm UTC](https://internals.rust-lang.org/t/document-breaking-changes-better/2791/12 "2015-10-18T16:52:43Z")

</div>

@bluss Yeah, perhaps a top-level post that outlines the current accepted wisdom around breaking changes and regressions would be an easy start. I still want to get the regression\* tags working in a more consistent way, and I’m not myself clear on how they should be used.

I realize I’m conflating breaking changes and regressions but they are closely related.

---

_[View the full topic](https://internals.rust-lang.org/t/document-breaking-changes-better/2791)._