included and improved descriptions and comments

Signed-off-by: Laura Sedman <laura.sedman@gmail.com>