Document v0.36 open()'s breaking change

[olegbespalov]

Document a breaking change of the open() function

[yorugac]

Formulation changes: please see the comment.

A related suggestion: perhaps it makes sense to add "good practice hints"? E.g. it's best if you open files like this: a), b), ...
Unless "best practices" section should be in another place and only linked here. WDYT?

[olegbespalov]

A related suggestion: perhaps it makes sense to add "good practice hints"? E.g. it's best if you open files like this: a), b), ...
Unless "best practices" section should be in another place and only linked here. WDYT?

I think it's a good idea, but on the other see that the opening of the files is a hot topic, so maybe it makes sense to add this section of the documentation once we make the improvements (for example, once there is more clarity with that issue)

[yorugac]

@olegbespalov yes, agreed on returning to this after grafana/k6#2311 👍