futriix/src/commands/ping.json
Itamar Haber 0c3b8b7e90
Overhauls command summaries and man pages. (#11942)
This is an attempt to normalize/formalize command summaries.

Main actions performed:

* Starts with the continuation of the phrase "The XXXX command, when called, ..." for user commands.
* Starts with "An internal command...", "A container command...", etc... when applicable.
* Always uses periods.
* Refrains from referring to other commands. If this is needed, backquotes should be used for command names.
* Tries to be very clear about the data type when applicable.
* Tries to mention additional effects, e.g. "The key is created if it doesn't exist" and "The set is deleted if the last member is removed."
* Prefers being terse over verbose.
* Tries to be consistent.
2023-03-29 20:48:59 +03:00

41 lines
998 B
JSON

{
"PING": {
"summary": "Returns the server's liveliness response.",
"complexity": "O(1)",
"group": "connection",
"since": "1.0.0",
"arity": -1,
"function": "pingCommand",
"command_flags": [
"FAST",
"SENTINEL"
],
"acl_categories": [
"CONNECTION"
],
"command_tips": [
"REQUEST_POLICY:ALL_SHARDS",
"RESPONSE_POLICY:ALL_SUCCEEDED"
],
"reply_schema": {
"anyOf": [
{
"const": "PONG",
"description": "Default reply."
},
{
"type": "string",
"description": "Relay of given `message`."
}
]
},
"arguments": [
{
"name": "message",
"type": "string",
"optional": true
}
]
}
}