# \[ANN\] DocumenterVitepress 0.2 with breaking changes

**URL:** <https://discourse.julialang.org/t/ann-documentervitepress-0-2-with-breaking-changes/128989>\
**Category:** Package Announcements\
**Tags:** documenter\
**Created:** [May 14, 2025, 9:32am UTC](https://discourse.julialang.org/t/ann-documentervitepress-0-2-with-breaking-changes/128989 "2025-05-14T09:32:48Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![jules](https://avatars.discourse-cdn.com/v4/letter/j/41988e/32.png) [@jules](https://discourse.julialang.org/u/jules)\
**Post date:** [May 14, 2025, 9:32am UTC](https://discourse.julialang.org/t/ann-documentervitepress-0-2-with-breaking-changes/128989/1 "2025-05-14T09:32:48Z")

</div>

I have just released DocumenterVitepress 0.2 which is breaking, so your docs workflows will break unless you have compat set to 0.1. Many people don’t have compat settings in their docs/Project.toml (myself included) so that’s something one should add for the future.

Please check the [README](https://github.com/LuxDL/DocumenterVitepress.jl) for updated build/deploy instructions, a short description of the breaking changes is in the [changelog](https://github.com/LuxDL/DocumenterVitepress.jl/blob/master/CHANGELOG.md).

The reason for the breaking release is that the deploy process for DocumenterVitepress was fundamentally broken. Many DocumenterVitepress sites have recently been serving 404s on the `stable` suburl.

 ![image](https://global.discourse-cdn.com/julialang/original/3X/b/b/bb7f69523f3b10d63285bc79bb14531d3d261f55.png)

That’s because Documenter’s `deploydocs` creates symlinks on `gh-pages` , for example, `stable` as an alias for `v1.2.3` , but vitepress sites may break if they live under a different sub-url than what they were originally rendered for. So 0.2 will render a separate site for each base and there’s a new `DocumenterVitepress.deploydocs` function to handle that multi-site folder structure.