Docs suggestions post

[rho]

Have any suggestions for things that you think should be documented but aren't, things about the current documentation that you think need improving, or any "hey, wouldn't it be neat if..." ideas that pertain to docs? Comment here with them, and I'll either fix them, put them in zilla, or explain why I don't want to do them.

Comments

OpenID Faqs

[ninetydegrees]

The topic of OpenID came up in my Circle as someone didn't understand how it worked and I've realized that FAQ#145 and #62 don't really explain what an OpenID is (that's it's generally a URL such as your blog's URL for blogging sites) or how to log in with it. It says you need to create an OpenID account (which seems to defeat the purpose of logging with an OpenID in the first place so why mention it so soon?) instead of telling you how to do that: copy the URL and paste it into the log in box. It doesn't tell you either that you need to be logged out of DW to be able to use it (not that obvious, imo).

FAQ#123 is a bit better but doesn't explicitly said what your LJ OpenID is and is, of course, meant for LJ users only.

Come to think of it, I think a FAQ telling you how to log in with OpenID is missing. The account thing should be secondary.