Do not expand on all possible function syntaxes in syntax boxes

[Josh-Cena]

Consider this Array method syntax box:

// Arrow function
map((element) => { /* … */ })
map((element, index) => { /* … */ })
map((element, index, array) => { /* … */ })

// Callback function
map(callbackFn)
map(callbackFn, thisArg)

// Inline callback function
map(function (element) { /* … */ })
map(function (element, index) { /* … */ })
map(function (element, index, array) { /* … */ })
map(function (element, index, array) { /* … */ }, thisArg)

This is extremely long, repetitive, and hard to maintain. Furthermore, we don't use this pattern in other places where a callback is accepted:

new Promise(executor)

JSON.stringify(value)
JSON.stringify(value, replacer)
JSON.stringify(value, replacer, space)

replace(pattern, replacement)

Is it possible that we stop expanding all callback syntaxes, but instead use parameter descriptions?

```js-online
map(callbackFn)
map(callbackFn, thisArg)
```

### Parameters

- `callbackFn`

  - : A function to execute for each element in the array. Its return value is added as a single element in the new array.

    The function is called with the following arguments:

    - `element`
      - : The current element being processed in the array.
    - `index`
      - : The index of the current element being processed in the array.
    - `array`
      - : The array `map()` was called upon.

This needs updates to the syntax guideline.

cc @mdn/yari-content-javascript

[teoli2003]

This sounds good to me.

[Elchi3]

I like your proposal. I originally worked this out when changing the syntax boxes in 2021, but whenever I looked at the callbacks specifically I wasn't quite happy with it. I wanted to make this beginner friendly but this part indeed got long and repetitive.

Context from 2021:
openwebdocs/project#26
mdn/content#4136
And especially mdn/content#4249

Happy to review a PR against the guidelines and to use parameters as you propose. https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Page_structures/Syntax_sections#callback_syntax_blocks

[OnkarRuikar]

• Can we close this? as the guidelines have been updated Avoid inline callback syntax in syntax boxes content#25752

Was this issue raised for only JavaScript? or the entire repo? API pages are still using the old style e.g. Web/API/Headers/forEach. Do we have to update rest of the repo as well?

[Josh-Cena]

I think we should update the web API pages as well. Maybe someone could do it?

[teoli2003]

mdn/content#26121 landed. Thanks to @Elchi3 !

[OnkarRuikar]

A few still remain e.g.

Web/JavaScript/Reference/Global_Objects/Array/toSorted
Web/JavaScript/Reference/Global_Objects/TypedArray/toSorted

It's hard to find the rest of them as the syntax sections are not uniform. May be one day we'll get them all.

[Josh-Cena]

Thanks @OnkarRuikar, those were created by race condition (the PR was created before the update and merged after the update). Welcoming PRs.