-
Notifications
You must be signed in to change notification settings - Fork 204
Remove normative descriptions #1231
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
Remove normative descriptions #1231
Conversation
The description is duplicated by the remote ends steps. It says exactly the same things.
This command's description is slightly misleading and doesn't really explain what happens. It can be useful to point out that it selects which browsing context will be the target for all subsequent commands. Also merges note in the remote end steps.
The description is self-explanatory.
|
||
<p> | ||
For example, consider this pseudo code | ||
which retrieves an element with the <code>#toremove</code> ID |
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 would be better with an html example since we don't say what an ID is.
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.
Mind if I file a follow-up to improve command introductions and examples?
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.
Filed #1233.
This PR is a continuation of #1105 to remove/improve/adapt command descriptions that could be mistaken as normative.
Preview | Diff