added missing elements and additionnal documentation