more error message review

1 files changed, 25 insertions, 24 deletions

diff --git a/gnu-taler-error-codes/registry.rec b/gnu-taler-error-codes/registry.rec
index 1428077..bc429fd 100644
--- a/gnu-taler-error-codes/registry.rec
+++ b/gnu-taler-error-codes/registry.rec
@@ -102,27 +102,28 @@ HttpStatus: 400
 
 Value: 24
 Name: GENERIC_PAYTO_URI_MALFORMED
-Description: The payto:// URI provided by the client is malformed. 
+Description: The payto:// URI provided by the client is malformed. Check that you are using the correct syntax as of RFC 8905 and/or that you entered the bank account number correctly.
 HttpStatus: 400
 
 Value: 25
 Name: GENERIC_PARAMETER_MISSING
-Description: A required parameter in the request was missing.
+Description: A required parameter in the request was missing. This is likely a bug in the client implementation. Check if you are using the latest available version and/or file a report with the developers.
 HttpStatus: 400
 
 Value: 26
 Name: GENERIC_PARAMETER_MALFORMED
-Description: A parameter in the request was malformed.
+Description: A parameter in the request was malformed. This is likely a bug in the client implementation. Check if you are using the latest available version and/or file a report with the developers.
 HttpStatus: 400
 
 Value: 27
 Name: GENERIC_RESERVE_PUB_MALFORMED
-Description: The reserve public key given as part of a /reserves/ endpoint was malformed.
+Description: The reserve public key was malformed.
 HttpStatus: 400
+FIXME: Fold with 26?
 
 Value: 28
 Name: GENERIC_COMPRESSION_INVALID
-Description: The body in the request could not be decompressed by the server.
+Description: The body in the request could not be decompressed by the server. This is likely a bug in the client implementation. Check if you are using the latest available version and/or file a report with the developers.
 HttpStatus: 400
 
 # Circumstantial client-side protocol problems (30-39)
@@ -130,17 +131,17 @@ HttpStatus: 400
 
 Value: 30
 Name: GENERIC_CURRENCY_MISMATCH
-Description: The currency involved in the operation is not acceptable for this backend.
+Description: The currency involved in the operation is not acceptable for this server. Check your configuration and make sure the currency specified for a given service provider is one of the currencies supported by that provider.
 HttpStatus: 400
 
 Value: 31
 Name: GENERIC_URI_TOO_LONG
-Description: The URI is longer than the longest URI the HTTP server is willing to parse.
+Description: The URI is longer than the longest URI the HTTP server is willing to parse. If you believe this was a legitimate request, contact the server administrators and/or the software developers to increase the limit.
 HttpStatus: 414
 
 Value: 32
 Name: GENERIC_UPLOAD_EXCEEDS_LIMIT
-Description: The body is too large to be permissible for the endpoint.
+Description: The body is too large to be permissible for the endpoint. If you believe this was a legitimate request, contact the server administrators and/or the software developers to increase the limit.
 HttpStatus: 413
 
 
@@ -174,37 +175,37 @@ HttpStatus: 403
 
 Value: 50
 Name: GENERIC_DB_SETUP_FAILED
-Description: The service failed initialize its connection to the database.
+Description: The service failed initialize its connection to the database. The system administrator should check that the service has permissions to access the database and that the database is running.
 HttpStatus: 500
 
 Value: 51
 Name: GENERIC_DB_START_FAILED
-Description: The service encountered an error event to just start the database transaction.
+Description: The service encountered an error event to just start the database transaction. The system administrator should check that the database is running.
 HttpStatus: 500
 
 Value: 52
 Name: GENERIC_DB_STORE_FAILED
-Description: The service failed to store information in its database.
+Description: The service failed to store information in its database. The system administrator should check that the database is running and review the service logs.
 HttpStatus: 500
 
 Value: 53
 Name: GENERIC_DB_FETCH_FAILED
-Description: The service failed to fetch information from its database.
+Description: The service failed to fetch information from its database. The system administrator should check that the database is running and review the service logs.
 HttpStatus: 500
 
 Value: 54
 Name: GENERIC_DB_COMMIT_FAILED
-Description: The service encountered an error event to commit the database transaction (hard, unrecoverable error).
+Description: The service encountered an unrecoverable error trying to commit a transaction to the database. The system administrator should check that the database is running and review the service logs.
 HttpStatus: 500
 
 Value: 55
 Name: GENERIC_DB_SOFT_FAILURE
-Description: The service encountered an error event to commit the database transaction, even after repeatedly retrying it there was always a conflicting transaction. (This indicates a repeated serialization error; should only happen if some client maliciously tries to create conflicting concurrent transactions.)
+Description: The service encountered an error event to commit the database transaction, even after repeatedly retrying it there was always a conflicting transaction. This indicates a repeated serialization error; it should only happen if some client maliciously tries to create conflicting concurrent transactions. It could also be a sign of a missing index. Check if you are using the latest available version and/or file a report with the developers.
 HttpStatus: 500
 
 Value: 56
 Name: GENERIC_DB_INVARIANT_FAILURE
-Description: The service's database is inconsistent and violates service-internal invariants.
+Description: The service's database is inconsistent and violates service-internal invariants. Check if you are using the latest available version and/or file a report with the developers.
 HttpStatus: 500
 
 
@@ -212,17 +213,17 @@ HttpStatus: 500
 
 Value: 60
 Name: GENERIC_INTERNAL_INVARIANT_FAILURE
-Description: The HTTP server experienced an internal invariant failure (bug).
+Description: The HTTP server experienced an internal invariant failure (bug). Check if you are using the latest available version and/or file a report with the developers.
 HttpStatus: 500
 
 Value: 61
 Name: GENERIC_FAILED_COMPUTE_JSON_HASH
-Description: The service could not compute a cryptographic hash over some JSON value.
+Description: The service could not compute a cryptographic hash over some JSON value. Check if you are using the latest available version and/or file a report with the developers.
 HttpStatus: 500
 
 Value: 62
 Name: GENERIC_FAILED_COMPUTE_AMOUNT
-Description: The service could not compute an amount.
+Description: The service could not compute an amount. Check if you are using the latest available version and/or file a report with the developers.
 HttpStatus: 500
 
 
@@ -230,32 +231,32 @@ HttpStatus: 500
 
 Value: 70
 Name: GENERIC_PARSER_OUT_OF_MEMORY
-Description: The HTTP server had insufficient memory to parse the request.
+Description: The HTTP server had insufficient memory to parse the request. Restarting services periodically can help, especially if Postgres is using excessive amounts of memory. Check with the system administrator to investigate.
 HttpStatus: 500
 
 Value: 71
 Name: GENERIC_ALLOCATION_FAILURE
-Description: The HTTP server failed to allocate memory.
+Description: The HTTP server failed to allocate memory. Restarting services periodically can help, especially if Postgres is using excessive amounts of memory. Check with the system administrator to investigate.
 HttpStatus: 500
 
 Value: 72
 Name: GENERIC_JSON_ALLOCATION_FAILURE
-Description: The HTTP server failed to allocate memory for building JSON reply.
+Description: The HTTP server failed to allocate memory for building JSON reply. Restarting services periodically can help, especially if Postgres is using excessive amounts of memory. Check with the system administrator to investigate.
 HttpStatus: 500
 
 Value: 73
 Name: GENERIC_CURL_ALLOCATION_FAILURE
-Description: The HTTP server failed to allocate memory for making a CURL request.
+Description: The HTTP server failed to allocate memory for making a CURL request. Restarting services periodically can help, especially if Postgres is using excessive amounts of memory. Check with the system administrator to investigate.
 HttpStatus: 500
 
 Value: 74
 Name: GENERIC_FAILED_TO_LOAD_TEMPLATE
-Description: The backend could not locate a required template to generate an HTML reply.
+Description: The backend could not locate a required template to generate an HTML reply. The system administrator should check if the resource files are installed in the correct location and are readable to the service.
 HttpStatus: 500
 
 Value: 75
 Name: GENERIC_FAILED_TO_EXPAND_TEMPLATE
-Description: The backend could not expand the template to generate an HTML reply.
+Description: The backend could not expand the template to generate an HTML reply. The system administrator should investigate the logs and check if the templates are well-formed.
 HttpStatus: 500