Added docs explaining why full type specs should be preferred