Topic/docs

Added the design document, there are some open points, but I will build those later when I have more details. I think this is a good enough start. 
Yes, morally correct. I.e. something we don't want convince you of, it is agreed or not.