docs: added documentation for socket.destroyed

[tusharmath]

Checklist

• documentation is changed or added
• the commit message follows commit guidelines

Affected core subsystem(s)

doc

Description of change

fixes: #5898

[tusharmath]

My apologies if some guidelines haven't been met. This is my first contribution.

[silverwind]

Can we add a bit more detail about what "destroyed" means?

[tusharmath]

For example?

[silverwind]

Look into the source to find out, I think something along the lines of "does not send or receive any more data, cannot be re-established", but I'm no expert on this topic :).

[svozza]

I think "indicates" might be a better choice of word than "depicts". Maybe something like this:

A Boolean value that indicates whether the connection has been destroyed or not.

[silverwind]

The subsystem should be doc.

[stevemao]

@nodejs/documentation

[benjamingr]

Hey, thanks, please wrap lines at 80 chars :)

[cjihrig]

@tusharmath ping. Are you still planning to work on this?

[tusharmath]

@cjihrig Made the updates.

[silverwind]

Might be me, but I think this sounds better:

A boolean value that indicates if the connection is destroyed, meaning it will not accept or deliver any more data.

Not strictly necessary for this PR, but I think some information whether a half-closed socket can be in a destroyed state might be good to add as well (haven't researched).

[cjihrig]

LGTM

[cjihrig]

Sorry, I do have one nit:

no data can further

should be

no further data can

[tusharmath]

@cjihrig update the changes

[cjihrig]

Sorry, I just realized this - can you maintain the alphabetical order of the docs.

[tusharmath]

@cjihrig Thanks for pointing it out :)

[cjihrig]

Thanks! Landed in 193afef.