Documentation of destination in .env is not sufficient

[AdrianRygiol]

Dear SAP Cloud SDK colleagues,

the documentation of the destination in .env file is not sufficient here:

https://github.com/SAP/cloud-sdk/blob/main/docs-js/tutorials/getting-started/2-execute-odata-request.mdx#manage-destinations-centrally-optional

With the sentence alone Every environment variable in the .env file has to be defined on one line I could not make it work.

I always got errors like Error in reading the given destinations from the environment variable Error in parsing the destinations from the environment variable...

After many attempts, finally I found out that the destination in .env must use quotation marks and must look as follows:

destinations='[{"name": "<DESTINATIONNAME_1>", "url": "<URL to your system>", "username": "<USERNAME>", "password": "<PASSWORD>",{"name": "<DESTINATIONNAME_2>", "url": "<URL to your system>", "username": <USERNAME>", "password": "<PASSWORD>"}]'

Could you please improve the documentation here and add such an explicit example for a valid .env string?

Thanks and best regards,
Adrian

[tomfrenken]

Hi @AdrianRygiol,

thank you for your feedback.

If I search for your exact use case of local destinations, I immediately find this entry in our documentation, do you feel like anything is missing here? Or would you rather hope for a dedicated .env file section, separate from e.g. the destinations subsection of our documentation?

[tomfrenken]

After reading through the documentation that you've linked, I can see how that can be confusing, I will create a PR to update this specific part of our documentation.