# Understanding changelogs

Copy as Markdown[View as Markdown](/docs/development/guides/changelogs/introduction.md)

***

In your architecture, various resources like domains, services, schemas, and boundaries are constantly evolving. **Unfortunately, the context or reason behind these changes often gets lost.**

EventCatalog changelogs allow you to capture these changes and help your team understand the history of your architecture.

### Features[​](#features "Direct link to Features")

* Powered by markdown, add a `changelog.mdx` to your domains, services and messages
* Automated diffs for `.json`, `.avro`, `.yml` and `.yaml` files.
* Custom components and MDX component support
* Timestamps and linear history on page

#### Example[​](#example "Direct link to Example")

![Example](/assets/images/changelog-b60ba4ecaafb228a61fd5a517d3c1428.png)

[You can see a changelog example here](https://demo.eventcatalog.dev/docs/events/InventoryAdjusted/1.0.1/changelog).