Extensive update of the main specs doc

I thoroughly reviewed the specs document and re-organised the content.
Several topics need to be further worked out. In general the open
questions and work topics are clearly marked in **bold**