Improve route documentation

[goncalossilva]

Routes are all documented like so:

ffs/ffs-server/src/main/kotlin/routes/FlagRoutes.kt

Lines 87 to 96 in 474b689

	/**
	* Create a new flag.
	*
	* On success, responds `201 Created` with an empty body.
	*
	* | Parameter | Required | Description |
	* | ----------------- | -------- | ------------------ |
	* | `name` | Yes | Name of the flag. |
	* | `rule` | Yes | Rule of the flag. |
	*/

There are several problems with this, like:

• Route documentation should be more easily accessible, i.e., in the public docs.
• All request parameters are documented, Query parameters are hit-or-miss.
• There is no example of what the full endpoint looks like in the docs themselves.