Our documentation describes how secrets can be used to mount a file (i.e. custom settings.xml) [1].

Devfiles can be used to make such a secret. 

But when the two points above are used together:  "A devfile defines a secret, the secret contains a file used by CRW" it does not work.  Timing (race conditions) arise.

The request:  Please place a small warning note near the documentation at [1] warning the user that such secrets should not be defined via devfile.  Something like this, perhaps:

----------------- Suggested text ----------------------------------------

Warning!  Secrets can be defined in a devfile.  Please do not use secrets defined this way for mounting files.  Race conditions can occur.  Instead, define secrets used for mounting files through the console or the CLI.

--------------------------------------------------------------------------------

[1] https://access.redhat.com/documentation/en-us/red_hat_codeready_workspaces/2.5/html-single/end-user_guide/index#mounting-a-secret-as-a-file-or-an-environment-variable-into-a-workspace-container_crw