I have tried to add a little more information, but I think it may be easier to assume the reader knows and then write an explanation on readthedocs or some other external source and reference to it in the example?