add documentation + warnings