Skip to content
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

Please clarify how to launch the first demo #39

Open
Chealer opened this issue Jul 4, 2016 · 0 comments
Open

Please clarify how to launch the first demo #39

Chealer opened this issue Jul 4, 2016 · 0 comments

Comments

@Chealer
Copy link
Contributor

Chealer commented Jul 4, 2016

The first demo contains:

Using HTML 'b' tag, chain commands for css() and animate(), id #special2
Test data and check it on callback phery:always
See the PHP code

The first line is the demo's title. The second line must be clicked to launch the demo. The last line must be clicked to toggle display of PHP code.
The last line's appearance makes it clear that it is clickable. This is unfortunately not the case with the second line, which in fact has the same appearance as the first line, which is not clickable. It could be argued that since the label is imperative, the reader should understand that it can be clicked, but:

  1. The first line is also imperative, and is not designed to be clicked
  2. "Test data" could be interpreted as a noun phrase, since "test" can be an adjective. This is particularly likely since "data" is never discussed. This could be avoided by putting "data" in italics, or by substituting "data" with "the data function".

Note that while it is clearer how to launch for most of the following examples, there are several more complex cases at the end where it is not clear for the user what should be done to see the demonstration.

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

No branches or pull requests

1 participant