added samples doc comments