Prepare release 1.2 of doc
Added final changelog in preface
1.2 full release - api and spec
prepare for next development iteration