It should be short in the doc string, although if no short example is possible, the gallery example is also fine.