Skip to content

[Bug]: CI docs warning: switch from material to zensical #808

@aldbr

Description

@aldbr

Search before creating an issue

  • I have searched existing issues and confirmed this is not a duplicate

Bug Description

We have the following warning in the CI:

 │ ⚠ WARNING – MkDocs 2.0 is incompatible with Material for MkDocs�[0m
�[31m │ �[0m
�[31m │ �[0m  MkDocs 1.x is unmaintained. We recommend switching to Zensical, our
�[31m │ �[0m  new static site generator, as soon as possible. We're providing an
�[31m │ �[0m  analysis of the situation in this article:
�[31m │ �[0m  
�[31m │ �[0m  �[4mhttps://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/�[0m

Steps to Reproduce

  1. Go to any PR
  2. Check the CI docs

Expected Behavior

No warning

Actual Behavior

Warnings

Environment

No response

Relevant Log Output

Additional Context

We need to move from material to zensical following their documentation that you can find in the logs.

Definition of Done

  • no warning anymore
  • use zensical

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions