Adding documentation about beans.xml. Closes #815.

is it really optional?