add example of a decument method to the manual

[Juraj-Sulimanovic]

Issue 1307

The example that is mentioned in the manual is missing.
I just added the example mentioned on the issue itself.

[pointlessone]

Thank you for your contribution.

However, I don't think this is a very good addition. Manual describes how the method can be defined in order to get a custom document and here a default one is defined instead. I believe the manual is clear enough on the optionality of the method and its purpose. So if you want to demonstrate that then at least add some options to the document so that it was clear why the method is present in the example.

[Juraj-Sulimanovic]

Thank you for your contribution.

However, I don't think this is a very good addition. Manual describes how the method can be defined in order to get a custom document and here a default one is defined instead. I believe the manual is clear enough on the optionality of the method and its purpose. So if you want to demonstrate that then at least add some options to the document so that it was clear why the method is present in the example.

Thank you for the constructive comment. I added some options in the method.
The failing spec is related to a different commit.

[pointlessone]

Thank you for your contribution. This has been merged outside of GitHub.