Docs: cleanup related to generating sources+resources
Docs: note that source generators can generate Scala and Java sources together.