[KZL-1050] Role template example in the documentation

[Yoann-Abbes]

What does this PR do?

Add an explicit template role to createRole

https://jira.kaliop.net/browse/KZL-1050

How should this be manually tested?

Netify

[kuzzle]

Snippets tests reports

SDK	Version	Tests overview
	v6	✔️
	v5	✔️
	v1	✔️
	v1	✔️
	v1	✔️
	v1	✔️

[scottinet]

Good idea, problematic implementation:

1. You put your example in the Query Syntax section, which is very misleading. Especially considering that you add an example in the HTTP query syntax documentation, and not in the Other Protocols one. If you want to put different examples in an API documentation page, you should create a new "Examples" section instead, at the end of the page
2. There is already a guide that provides extended explanations, so I personally wouldn't add multiple examples in that page: https://docs.kuzzle.io/guide/1/essentials/security/#defining-roles

My suggestion:

1. Remove the 'example' part of your PR
2. Edit that API documentation page to add a backlink to the guide page I mention above
3. Replace the query syntax template by the one you added, as it looks more detailed (but you have to do that for both the HTTP and the Other Protocols query syntax templates)

[Aschen]

In the same time you could give the example of the minimum rights for the admin console in the Configure Security page instead of the actual example