Updated documentation + dev doc + changelog

@shin- @samalba title says all.