[Docs] JSDoc `boolean` vs `Boolean`

[AbdelrahmanHafez]

Prerequisites

• I have written a descriptive issue title
• I have searched existing issues to ensure the issue has not already been raised

Issue

re #16009 (comment)

[vkarpov15]

WDYT, is this worth doing? On one hand updating Boolean -> boolean in our JSdoc types isn't an urgent priority, but I do think it would be nice for our JSdoc types to line up with TypeScript types for clarity.

[AbdelrahmanHafez]

Yeah I checked earlier today and boolean is actually valid JSDoc, I went ahead and did some work on this locally and aligned our JSDoc with TS types as much as possible, I'll submit a draft PR just to take a look there.