New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Emit INFO instead of WARNING for Deprecated options #3696
Comments
Hi @kcgthb, thanks for opening this issue :) I have read the discussion in Material for MkDocs' repository, and to me it would make sense to let users decide whether to emit info or warning messages for plugin configs using the I recently added a breaking change in mkdocstrings-python, with a deprecation period where users will first get info logs (not breaking their strict builds), then warnings (now breaking them). Back to this issue, I wonder though if we should allow setting info level globally, or per deprecation message. |
I 💯 agree that allowing users to choose the message level ( |
@tomchristie 👋 in my view, this issue is a great start for improving MkDocs, as it touches many users. Basically, when you're using It would be great if you could share your view |
Could you expand on that? The first part "when you're using --strict mode, your build will fail if you run into a plugin deprecation" seems right, sounds like it's the inconsistency that needs addressing? |
I did expand on it in the comment I linked: squidfunk/mkdocs-material#7146 (comment)
|
Hi!
Currently, the Deprecated helper emits a
WARNING
message when a deprecated option is used, which breaks building sites in strict mode.This is causing an issue with MkDocs Material, where a deprecated option is still useful in some cases (see a full description in squidfunk/mkdocs-material#7146).
On @squidfunk's suggestion, would it be possible to consider emitting an
INFO
message instead of aWARNING
whenDeprecated
is used, a bit like it was done in #2907?Thanks!
The text was updated successfully, but these errors were encountered: