Skip to content

Commit e1c1bad

Browse files
committed
Updated blog post
1 parent 2445537 commit e1c1bad

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

docs/blog/posts/transforming-material-for-mkdocs.md

+5
Original file line numberDiff line numberDiff line change
@@ -137,13 +137,18 @@ We had considered developing a live editor in response to MkDocs' [performance i
137137
[^7]:
138138
After [we raised this issue] with the maintainers of MkDocs again[^8], and [maintainership changed] mid 2024, work on a [ground-up rewrite] that aims to address slow reloads by [rendering only the page currently being built] has started. It's still unclear how this rewrite will integrate with the requirements of existing plugins. Complex plugins such as [mkdocstrings], or our [built-in blog] and [tags] plugins require a coordinated build of all pages to accurately resolve links between pages and to computed resources, which cannot be determined without building the entire project.
139139

140+
__Update__{ title="August 21, 2024" }: The new maintainer now publicly stated that he's working towards a new version of MkDocs that [does not require or support plugins], and mentions it will be equally capable through offering customization via templating, themes, and styling, which he also mentioned to us and several other users in [a team call on August 1]. In this call, [we raised objections multiple times] in regards to how this will impact the ecosystem, to no avail. No intention or roadmap for plugin support was provided. This development is orthogonal to our goal empowering users and organizations to adapt the core framework to their requirements by the means of modularity. We're working on resolving this situation, and will provide a way forward for our community.
141+
140142
[we raised this issue]: https://github.com/mkdocs/mkdocs/issues/3695
141143
[maintainership changed]: https://github.com/mkdocs/mkdocs/discussions/3677
142144
[ground-up rewrite]: https://github.com/mkdocs/sketch
143145
[rendering only the page currently being built]: https://github.com/mkdocs/mkdocs/issues/3695#issuecomment-2117939743
144146
[mkdocstrings]: https://mkdocstrings.github.io/
145147
[built-in blog]: ../../plugins/blog.md
146148
[tags]: ../../plugins/tags.md
149+
[does not require or support plugins]: https://github.com/mkdocs/mkdocs/discussions/3815
150+
[a team call on August 1]: https://github.com/mkdocs/mkdocs/discussions/3671#discussioncomment-10164237
151+
[we raised objections multiple times]: https://github.com/mkdocs/mkdocs/discussions/3671#discussioncomment-10215445
147152

148153
[^8]:
149154
Previously raised issues include [#2418], [#2384], and [#1900].

0 commit comments

Comments
 (0)