1.3 Final, and documentation

1.3 Final, and documentation

Apparently, 1.3 was declared Final this morning. (Though there's some ambiguity on the website, with it referred to as both "Final" and "RC1".)

At the same time, the documentation has switched over to a new format. There is now separate API documentation, which is very rough:

http://api.jquerymobile.com/

Now the demo is just a demo/examples: (no it isn't, see "update" below...)

http://view.jquerymobile.com/1.3.0/#&ui-state=dialog&ui-state=dialog

While the old documentation was hard to navigate, because it couldn't decide if it was a demo or a tutorial or API documentation, and didn't have any kind of index, table of contents, it was vastly more usable than the current documentation.

The tutorial material in the old docs seems to have fallen between the cracks, and now there is nothing to tell us how to initially set-up a JQM project (save for very basic CSS/JS loading setup on the "download" page) nor anything that explains basic principles, such as the page navigation model.

As a practical matter, you will need to refer to the 1.2 documentation if you are just starting out:

http://jquerymobile.com/demos/1.2.0/

In particular, the "Pages and Dialogs" section, which contains a great deal of tutorial/intro material seems missing.

Update: the tutorial material is there, but not very accessible. You will need to click around on links in the Introduction section of the new demos, and guess which ones might be important to read. Alas, there still is not a real separation between demo and documentation, except that there is now a separate API documentation. They've "improved" the tutorial material by burying it behind inline links, where at least before it was nicely organized in a menu.

Basic getting-started info (like what to put in <head> to link to CSS and JS) can be found by going to the Introduction, scroll down to "Pages & Dialogs", then click on the "page" link in the first paragraph of that section.

Not sure what has become of the "old format" docs for 1.3.

IMO, both of the new documents hurt my eyes. It's why I'm wearing sunglasses. ;)

(It's not quite so bad on a Retina device like iPad. On most desktop displays, the font is way too thin and hard to read.)