There's no clear instructions on how to use it so most people are confused.

There should be a getting started that makes clear that the framework works by adding classes on html tags and that's about it.

There is indeed a GETTING-STARTED.md file, and its relatively well-written, imho. It answers all sorts of things you may ask .. "There's no clear instructions" !true, imho.

EDIT: Plus, if you follow the documents in the sources (i.e. README and so on ..) you get to http://learnsemantic.com/ .. which is clearly a useful set of documents for developer needs. Quite some polish.

Do you have a link to that story?

Reposting from down below: http://blog.readability.com/2012/06/announcement/

The site doesn't send anything at all to the identity provider. Your browser sends an authentication requests to the identity provider and relay it the site it wants to log into.

The site then checks the request is really signed by the identity provider and lets the user in.

The identity provider knows two things:

- You asked to log in somewhere - At least one person logged to site X because site X asked for its public key