Improve docs about allowing some side effects on the constructor

See merge request gitlab-org/gitlab-ce!17027