Unclear documentation for composite decorator

[Zac-HD]

See e.g. https://stackoverflow.com/questions/50876547/ - we should explicitly explain that "the @composite decorator converts a functions which returns an example into a function which returns a strategy that generates such examples", or something to that effect.