Add doc comments explaining some return types