added new documentation and fixed comments in samples