more docs (I will certainly put the same messages a million times because I update this file everyday now)