Skip to content

Some examples are not user-friendly #308

Closed
@David263

Description

@David263

This page (http://learn.jquery.com/effects/uses-of-queue-and-dequeue/, https://github.com/jquery/learn.jquery.com/blob/master/page/effects/uses-of-queue-and-dequeue.md, and http://gnarf.net/2010/09/30/the-uses-of-jquery-queue-and-dequeue/) has some "Quick Examples", specified internally as for "beginners" that are not user-friendly.

The examples are not set up as running examples. In fact, they will not actually run and do anything without more code. I guess the visitor is expected to be an expert programmer who can read and understand JS and jQuery, but this contradicts these as "beginner" examples.

This may be the tip of an iceberg: there may be a similar usability problem with many other examples in the documentation of jQuery and associated libraries. I cannot address this larger issue; someone else, a jQuery developer, needs to become concerned. Good examples, that run when clicked and do something self-explanatory, are essential throughout the documentation.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions