doc: add documentation on porting from Buffer(arg) usage

[ChALkeR]

Refs: #19079

As previously discussed, it would be great if we could provide that instructions somewhere (docs, news, medium, whatever).

I made an initial draft in my repo here: Porting-Buffer.md, and @addaleax contributed significant parts of it.

What would be the next steps to discuss it and fix it so that it could be included somewhere?
I guess that needs to be done in time for 10.0 release.

Also: comments/patches to the doc at its current state are welcomed.

/cc @nodejs/tsc

[mcollina]

I think the best place is a medium blog post or a guide https://nodejs.org/en/docs/guides. Or both.

[ghost]

The deprecation of the Buffer constructor was documented here: https://github.com/nodejs/node/wiki/Breaking-changes-between-v5-and-v6.
The node docs also mark those methods are deprecated.
I went through that process for a code base and I think this was well documented.

[Trott]

/ping @nodejs/tsc

[Trott]

This is on the TSC agenda for this week, but it's not clear to me what the TSC needs to actually decide. Can we get a brief explanation of what is needed from the TSC on this? @ChALkeR

[Trott]

@nodejs/buffer

[fhinkel]

ping @ChALkeR Is there anything we need to discuss? Or is it just FYI on the tsc agenda?

[Trott]

I created a pull request with some improvements, but nothing that changes the actual meaning of any text significantly. ChALkeR/safer-buffer#5

@fhinkel In the TSC meeting, we agreed to give this doc editing until today and then hand it off to...you, was it? I obviously did not get to go over this as thoroughly as I had hoped, but if someone else has more time and/or energy, great! If we can publish it somewhere that others can continue to edit and improve it, then I think it's ship-able. (I'm almost sorry that we don't have the nodejs repo wiki anymore.)

[fhinkel]

Thanks @Trott, I'm on it right now 😺

[BridgeAR]

Hey, should this issue actually be closed or stay open? It was just weird that a commit from the wrong repo closed it.

[fhinkel]

Closed.

[fhinkel]

Here it is: https://nodejs.org/en/docs/guides/buffer-constructor-deprecation/