cleaning docs (to add docs)

this is a byzantine process, removing commits to get clean commits. Ah
well, that's what happens when OS devs design process flow :\