comments for the comments

-forgot to add something to the availability controller
-added some javadoc comments