Skip to content

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

Merged
merged 36 commits into from
Feb 22, 2018
Merged

Remove normative descriptions #1231

merged 36 commits into from
Feb 22, 2018

Conversation

andreastt
Copy link
Member

@andreastt andreastt commented Feb 21, 2018

This PR is a continuation of #1105 to remove/improve/adapt command descriptions that could be mistaken as normative.


Preview | Diff

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
Copy link
Contributor

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.

Copy link
Member Author

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?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Filed #1233.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants