Change Details

* Make sure it's: * consistent * future-proof (we should avoid changing it after users start relying on it) * user-friendly * well-documented

Make sure it's: * consistent * future-proof (we should avoid changing it after users start relying on it) * user-friendly * well-documented

* Make sure it's: * consistent * future-proof (we should avoid changing it after users start relying on it) * user-friendly * well-documented