{"comment":{"created_at":"2011-10-18T12:59:49Z","body":"We're starting to address this material in the Field Guide.\r\n\r\nOpenID comparison: \r\nhttp://mozilla.github.com/browserid-field-guide/browserid_for_sys_admins.html\r\n\r\nWe'd love more issues or patches with prose.","updated_at":"2011-10-18T12:59:49Z","url":"https://api.github.com/repos/mozilla/browserid/issues/comments/2441330","id":2441330,"user":{"avatar_url":"https://secure.gravatar.com/avatar/4021c2acfc5b98b6dfe2d0ec26432ce1?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png","gravatar_id":"4021c2acfc5b98b6dfe2d0ec26432ce1","url":"https://api.github.com/users/ozten","id":18924,"login":"ozten"}},"action":"created","issue":{"number":426,"created_at":"2011-10-14T17:11:02Z","pull_request":{"diff_url":null,"patch_url":null,"html_url":null},"body":"Currently the immediately available information about BrowserID (e.g. https://browserid.org/about ) is\r\n* for the end user only, explaining how to register and log into sites using BrowserID (which, for its current state, is similar to OpenID),\r\n* or is spread through the blog ( http://identity.mozilla.com/ ), which contains both posts with that end-user info and posts with object names. Also, the blog’s design (fonts, colors, plugins I don’t have) makes searching information in it inconvenient.\r\n\r\nHow I couldn’t find what I wanted\r\n====================\r\nI already used OpenID, so I was interested in the difference between it and BrowserID. I am not a developer, so I skipped the paragraph about JavaScript, and tried to watch videos. But some videos are also end-user-oriented, although being videos they take time and are not well-seekable. So I didn’t bother to read through the whole blog to find the right post mentioning certificates. However readable though, a blog wouldn’t be a good place for a just-came-there newbie’s introduction, IMO (unless its top post is an FAQ itself).\r\n\r\nWhat the FAQ should explain\r\n=================\r\n* How BrowserID is different from OpenID, and/or how it _will_ be different\r\n** Be clear on which is which of the current state and are the future plans; current browserid.org Privacy Policy appears to state the opposite of the privacy intent: “As part of the normal operation of the BrowserID service, Mozilla will retain a log of which sites you have disclosed your email to.”).\r\n** The phrase “Trusted 3rd party signs a certificate that you store in your browser” at https://wiki.mozilla.org/Identity/Verified_Email_Protocol explained the difference from OpenID to me, because I have used GnuPG before.\r\n* If a browser extension is needed, and what the provided extension does.\r\n* Which browsers work, and which don’t (and why not all do).","comments":3,"title":"Create a medium-technical FAQ page ","updated_at":"2011-10-18T12:59:49Z","url":"https://api.github.com/repos/mozilla/browserid/issues/426","id":1912316,"assignee":null,"milestone":null,"closed_at":null,"user":{"avatar_url":"https://secure.gravatar.com/avatar/6cda3f8ca8b6fd256b831e6dbb155127?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png","gravatar_id":"6cda3f8ca8b6fd256b831e6dbb155127","url":"https://api.github.com/users/aleksejrs","id":1025861,"login":"aleksejrs"},"html_url":"https://github.com/mozilla/browserid/issues/426","labels":[{"name":"doc","url":"https://api.github.com/repos/mozilla/browserid/labels/doc","color":"DDDDDD"},{"name":"★★","url":"https://api.github.com/repos/mozilla/browserid/labels/%E2%98%85%E2%98%85","color":"50c21a"}],"state":"open"},"legacy":{"issue_id":1912316,"comment_id":2441330}}