Also, it is very important that the documentation conveys intuitions on what the method does and the different aspects e.g. the meaning of the different parameters and how to choose them. Something that often helps is to put an image that comes from the example and to comment on it.