Skip to content

Tabs UI docs miss much useful content from 1.8. #121

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

Closed
twhitmorenz opened this issue Apr 24, 2013 · 4 comments
Closed

Tabs UI docs miss much useful content from 1.8. #121

twhitmorenz opened this issue Apr 24, 2013 · 4 comments

Comments

@twhitmorenz
Copy link

Tabs UI docs miss much useful content from 1.8.

  • in particular I needed the "Flash of Unstyled Content" details,
  • but AJAX stuff, how to open links in the current tab,
  • and details as to why "dimensional" widgets break down;
    would all be useful.

See: http://docs.jquery.com/UI/API/1.8/Tabs

Throwing all the good stuff & useful information out for the sake of consistency in some kind of simple format, isn't the right solution.

Maybe there needs to be an extra section of usage tips & notes in the docs, beyond 'Options, Methods and Events'? Such as Usage Notes?

@scottgonzalez
Copy link
Member

Feel free to suggest specific articles for https://github.com/jquery/learn.jquery.com

@twhitmorenz
Copy link
Author

Specific articles? Perhaps one on Tabs.

  • how to prevent FOUC,
  • why "dimensional" widgets break down,
  • and perhaps the other couple of things I mentioned.

Really for such information/ artilce on "learn.jquery.com" to be findable by developers, there probably would have to be links to it from the API or jQuery UI pages.

eg from http://api.jqueryui.com/tabs/

If there's no link from there, 90% of the people who would have use for that information won't find it -- or will only discover it eventually, after hours further research.

None of my research yesterday into Tabs or Autocomplete ever found the "Learn jQuery" site. Mainly it was the current and 1.8 sites, many StackOverflow pages and a few various blogs. The "Learn jQuery" site never featured.

Thanks.

@twhitmorenz
Copy link
Author

Perhaps we can leave this issue open, until there's a link from current jQuery UI API docs to the relevant info on Learn jQuery or wherever.

Since the issue hasn't actually been solved, yet.

@scottgonzalez
Copy link
Member

Half of the things you want us to mention are either bad ideas or don't really make sense with the API changes. If you want a specific thing mentioned, please file an issue for that one thing.

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

No branches or pull requests

2 participants