The wiki located here: http://labs.jboss.com/wiki/Jbosssso is the best source of documentation for the project at this time.
Also as far as examples go, take a look at the "test" folder in the src distribution for ideas of how some of the test scenarios are setup
thanks Sohil. appreciate it. i had another post about a JBoss Portal role issue. Essentially, i am not able to view the "dashboard" page as a user that I seeded (populated jbp_users and jbp_role_management tables) though i can login as that user.. if you have any thoughts on that, that would be great. thanks.