Use square brackets to denote optional parameters

[ramya-rao-a]

JSDoc suggests certain formats when it comes to optional parameters and parameters with default values. See https://jsdoc.app/tags-param.html#optional-parameters-and-default-values

Storage libraries followed this guideline until #5791 where it got removed.

This issue is to discuss if we should indeed follow the above format and if yes, then to add it to not just storage, but all other libraries

[XiaoningLiu]

Hi Ramya, I think JSDoc takes this as a rule/standard instead of a suggestion. We need to follow them if Azure JS SDK decides to follow JSDoc.

[ljian3377]

What's the status of storage packages now regarding the guideline?
Can we add some pipeline rule to enforce it?

[ramya-rao-a]

I'll close this in favor of #3027.
In the coming months we will look into linter checks that we can add which will help here