# Figuring out how to upgrade rstcheck to 6 for docs builds

**URL:** <https://forum.ansible.com/t/figuring-out-how-to-upgrade-rstcheck-to-6-for-docs-builds/7428>\
**Category:** Project Discussions\
**Tags:** documentation\
**Created:** [July 23, 2024, 3:35pm UTC](https://forum.ansible.com/t/figuring-out-how-to-upgrade-rstcheck-to-6-for-docs-builds/7428 "2024-07-23T15:35:20Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [July 23, 2024, 3:35pm UTC](https://forum.ansible.com/t/figuring-out-how-to-upgrade-rstcheck-to-6-for-docs-builds/7428/1 "2024-07-23T15:35:21Z")

</div>

TL;DR; - we’ve pinned `rstcheck` in the community and core package builds to \< 6 because it triggers failures due to [Update docs build requirements · Issue #78478 · ansible/ansible · GitHub](https://github.com/ansible/ansible/issues/78478#issuecomment-1426250919).

Based on that info, it looks like what was failing was caused by our use of reusable snippets. Since the underling `rstcheck` bug isn’t fixed afaik, maybe it’s time we reconsider reusable snippets so we CAN actually modernize `rstcheck`?

Looks to be less than 20 reused snippets in the docs repo. Of course how many places they would need to be updated is a different story. And a cursory read of the problem suggests not all snippets have to go, but any that use sphinx directives would have to be replaced somehow.

So before opening an issue to do this, what do folks think? Is it worth troubleshooting this once again to see if there is a way we can get away from this pinning to and old version of `rstcheck` even if it means stopping reusable snippets of docs?

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [July 23, 2024, 4:36pm UTC](https://forum.ansible.com/t/figuring-out-how-to-upgrade-rstcheck-to-6-for-docs-builds/7428/2 "2024-07-23T16:36:24Z")

</div>

DaWGs meeting consensus was yes, since we don’t have heavy use of snippets, let’s try out rstcheck 6 and see if we can replace the problematic snippets.

Note: check out the [rstcheck migration guide](https://rstcheck.readthedocs.io/en/latest/migrations/) for what other changes might be necessary.
