I'm very glad to announce that we are working on a documentation for PicketLink using Confluence.
This documentation is organized in a Getting Started Guide and a User Guide. Today, only the Getting Started is documented and we are still adding more info when necessary. The current version is focused in PicketLink Federation SAML Support with JBoss AS v7, only. We are still working to add informations about other federation protocols such WS-Trust, OpenID, etc.
PicketLink have a lot of usefull articles and docs, this new documentation aims to consolidate all of them in a single place. I think this will make things easier for all of us.
We would appreciate your feedback and comments.
About the IDM, PicketLink provides only an API to build IDM applications (as you want a solution for AS7).
Take a look in this doc about Seam 3 and PL IDM.
Seam 3 provides some IDM features based on PL IDM. I think they also have a example application using this IDM features.
I hope this can get you started ...