Added some internal documentation to make things clearer [ci skip]