A full page write-up is not necessary or appropriate.  Documentation is done in the profiles, not the examples.  As indicated in the resolution to 22963, examples will be updated to have embedded comments to provide guidance/clarification where the content is not self-explanatory.  As well, the examples will be explicitly tied to particular points in the formal specification to highlight what point in the workflow they're demonstrating.  Examples will also have short descriptions that explain their purpose and provide a short overview of what they're conveying.