Migrate documentation from mkdocs to Zensical #177

New Issue

MrUnknownDE · 2026-04-05T16:22:40+02:00

MrUnknownDE commented

2026-04-05 16:22:40 +02:00

Originally created by @jeremystretch on 3/10/2026

Proposed Changes

Migrate the documentation build system from mkdocs to Zensical.

Justification

The original mkdocs project appears to no longer maintained. Its ostensible successor, dubbed mkdocs 2.0 but perhaps more accurately described as a fork, does not support mkdocs-material and thus is not a viable option. The migration effort appears to be pretty minimal.

*Originally created by @jeremystretch on 3/10/2026* ### Proposed Changes Migrate the documentation build system from `mkdocs` to [Zensical](https://zensical.org/about/). ### Justification The original mkdocs project appears to no longer maintained. Its ostensible successor, dubbed mkdocs 2.0 but perhaps more accurately described as a fork, [does not support mkdocs-material](https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/) and thus is not a viable option. The migration effort appears to be pretty minimal.

MrUnknownDE closed this issue

2026-04-05 16:22:41 +02:00

Sign in to join this conversation.

Branches Tags

main

21455-sql-indexes-audit

21357-register-model-actions

feature

20924-plugin-ui-components

21766-improve-test-coverage-for-sortable-table-columns

21157-export-template-public-models

21025-pre-render-config-contexts

21364-swagger

feature-ip-prefix-link

20911-dropdown-3

fix_module_substitution

21160-filterset

20911-dropdown-2

20044-elevation-stuck-lightmode

7604-filter-modifiers-v3

20660-script-load

19724-graphql

14884-script

19720-macaddress-interface-generic-relation

fix-19669-api-image-download

7604-filter-modifiers

19275-fixes-interface-bulk-edit

fix-17794-get_field_value_return_list

11507-show-aggregate-and-rir-on-api

9583-add_column_specific_search_field_to_tables

No Label netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted type: housekeeping type: housekeeping type: housekeeping type: housekeeping type: housekeeping type: housekeeping

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github/netbox#177