Thanks for the feedback, that's a fair point. Because there are lots of examples in the main document and readme I thought it might be okay to leave the synopsis basically bare, but I see now that I should lead with more examples.