-
-
Notifications
You must be signed in to change notification settings - Fork 31.1k
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
Doc'd that users with unusable passwords cannot request a password reset. #15346
Conversation
Hello @amingilani! Thank you for your contribution 💪 As it's your first contribution be sure to check out the patch review checklist. If you're fixing a ticket from Trac make sure to set the "Has patch" flag and include a link to this PR in the ticket! If you have any design or process questions then you can ask in the Django forum. Welcome aboard ⛵️! |
Hello! I'm bumping this for feedback :) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Clarification makes sense, thank you! Added a comment to comply with current docs style.
docs/ref/contrib/auth.txt
Outdated
.. note:: | ||
Users marked with an unusable password will not | ||
able to request a password reset email via | ||
:class:`~django.contrib.auth.views.PasswordResetView`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We try to avoid having bare notes in the docs, we prefer admonitions with meaningful titles. For example:
.. note:: | |
Users marked with an unusable password will not | |
able to request a password reset email via | |
:class:`~django.contrib.auth.views.PasswordResetView`. | |
.. admonition:: Password reset restriction | |
Users having an unusable password will not able to request a | |
password reset email via | |
:class:`~django.contrib.auth.views.PasswordResetView`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you! I've incorporated your suggestion in my patch :)
c36303e
to
095aa78
Compare
Users having an unusable passwords will not be able to request password reset emails. This important information is only found in the PasswordResetView docs, and not in the set_unusable_password docs. This patch rectifies this shortcoming and places the information where it is needed.
095aa78
to
ab55db0
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you, looks good!
Include warning around unusable passwords Users having an unusable passwords will not be able to request password reset emails. This important information is only found in the PasswordResetView docs, and not in the set_unusable_password docs. This patch rectifies this shortcoming and places the information where it is needed.