-
Notifications
You must be signed in to change notification settings - Fork 22.5k
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
docs: making information about read-only clearer #33193
Conversation
Signed-off-by: Christine Belzie <[email protected]>
This reverts commit 4eefd1a.
Preview URLs (comment last updated: 2024-05-29 15:27:26) |
@@ -7,7 +7,7 @@ browser-compat: css.selectors.read-only | |||
|
|||
{{CSSRef}} | |||
|
|||
The **`:read-only`** [CSS](/en-US/docs/Web/CSS) [pseudo-class](/en-US/docs/Web/CSS/Pseudo-classes) represents an element (such as `input` or `textarea`) that is not editable by the user. | |||
The **`:read-only`** [CSS](/en-US/docs/Web/CSS) [pseudo-class](/en-US/docs/Web/CSS/Pseudo-classes) matches elements that do not match **:`read-write`**, such as an element that a user or checkbox cannot edit. |
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.
Say what a feature is rather than what it is not. We should define :read-only
without referring to :read-write
as the reader will have to fully understand read-write
(which should be a link, if we were to use it). this could lead to circular references.
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.
Hi @estelle! :) I made the changes
@@ -7,7 +7,7 @@ browser-compat: css.selectors.read-only | |||
|
|||
{{CSSRef}} | |||
|
|||
The **`:read-only`** [CSS](/en-US/docs/Web/CSS) [pseudo-class](/en-US/docs/Web/CSS/Pseudo-classes) represents an element (such as `input` or `textarea`) that is not editable by the user. | |||
The **`:read-only`** [CSS](/en-US/docs/Web/CSS) [pseudo-class](/en-US/docs/Web/CSS/Pseudo-classes) selects elements that are readable only. |
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.
This change basically states "read-only is read only". The original is more helpful. Let's keep the original. Closing.
Description
The first sentence in the
:read-only
entry was ambiguous. So, I changed the description.Motivation
Making this change would ensure that developers know how to effectively use this CSS property.
Additional details
Related issues and pull requests
#29140