Updated Documentation

Updated documentation, wiht better examples and clearer explanations