Deprecated your connect method but docs still reference it

General information

• SDK/Library version: 3.0.0
• Environment: Production and Sandbox
• Language, language version, and OS: Node 14.11.0 on macOS 10.15.6

Issue description

On https://developers.braintreepayments.com/start/hello-server/node, the example given is:

var braintree = require("braintree");

var gateway = braintree.connect({
  environment: braintree.Environment.Sandbox,
  merchantId: "useYourMerchantId",
  publicKey: "useYourPublicKey",
  privateKey: "useYourPrivateKey"
});

But in 3.0.0, you deprecated the connect() method according to the CHANGELOG. The CHANGELOG also doesn’t state the method that replaced it.

Can you improve your documentation? Deprecating a method like this without any advance warning creates some risk.

[crookedneighbor]

The docs are now updated: https://developers.braintreepayments.com/start/hello-server/node#install-and-configure

Here’s a migration guide for going from v2 to v3: https://developers.braintreepayments.com/reference/general/server-sdk-migration-guide/node

[nstuyvesant]

Here’s an example I was able to get working by looking at one of Braintree’s tests…

import braintree from 'braintree';
import config from '../../config/environment';

// Gets a token from Braintree
export async function index(req, res) {
  const gateway = new braintree.BraintreeGateway(config.gateway); // synchronous call

  // Generate the client token
  const { clientToken } = await gateway.clientToken.generate({});
  res.status(200).send(clientToken);
  return clientToken;
}