Add sub projects documentation

Move to SubProject.cmake so that it's updated with it. Please also add documentation for _IS_SUBPROJECT.