documented part of the code