Versioning
Added in
eventcatalog@2.13.0
All content in EventCatalog can be versioned. This allows you to keep historic versions of content which can give context to users why things are changing.
How to version a channel​
- Create a
/versioned
directory inside the/channels
folder if one is not created already. - Create a new folder with the version number inside the folder.
- Example:
/channels/OrdersChannel/versioned/0.0.1
- Example:
- Copy contents into the new folder, it at least needs your index.md file.
- Example:
/channels/OrdersChannel/versioned/0.0.1/index.md
- Note: the version inside this index.md file would be
0.0.1
- Example:
- Bump the version of the
index.md
file in the route of the channel.- Example
/channels/OrdersChannel/index.md
, change theversion
to0.0.2
- Example
How to navigate to versions​
EventCatalog will automatically create links for you within your latest version of your document. Users will also be able to navigate to any version by adding the version in the url (e.g /docs/channels/OrdersChannel/1.0.2 would load the 1.0.2 version of this channel).