completed the documenting comments