Update links (#1949)

* Update links

* Create strange-insects-grin.md

---------

Co-authored-by: Tobias Deekens <[email protected]>

Author: industrian

.changeset/strange-insects-grin.md

@@ -0,0 +1,18 @@
+---
+"@commercetools/api-request-builder": patch
+"@commercetools/get-credentials": patch
+"@commercetools/http-user-agent": patch
+"@commercetools/personal-data-erasure": patch
+"@commercetools/resource-deleter": patch
+"@commercetools/sdk-auth": patch
+"@commercetools/sdk-client": patch
+"@commercetools/sdk-middleware-auth": patch
+"@commercetools/sdk-middleware-correlation-id": patch
+"@commercetools/sdk-middleware-http": patch
+"@commercetools/sdk-middleware-logger": patch
+"@commercetools/sdk-middleware-queue": patch
+"@commercetools/sdk-middleware-user-agent": patch
+"@commercetools/sync-actions": patch
+---
+
+Update links to documentation.

CONTRIBUTING.md

@@ -31,7 +31,7 @@ accurate comments, etc.) and any other requirements (such as test coverage).
 5.  Integration tests are separated out in another folder "/integration-tests". To run the integration test, you need to export the environment variables into the process env by doing the following :-
 
     - Export `npm_config_projectkey` = `projectKey`,
-    - Export `CT_PROJECT_KEY`=`CLIENT_ID`:`CLIENT_SECRET` as specified [here](https://commercetools.github.io/nodejs/sdk/api/getCredentials.html).
+    - Export `CT_PROJECT_KEY`=`CLIENT_ID`:`CLIENT_SECRET` as specified [here](https://commercetools.github.io/nodejs/sdk/api/getCredentials).
     - Then run integration test with `pnpm test:integration`
 
 **Note: Due to the setup/teardown nature of the integration tests, there is the risk of potential data loss in your project**

docs/cli/personal-data-erasure.md

@@ -16,7 +16,7 @@ A package which deletes or exports [commercetools personal data](#list-of-person
 The constructor accepts two arguments:
 
 - A required object containing the following values:
-  - `apiConfig` (Object): `AuthMiddleware` options for authentication on the commercetools platform. (Required. See [here](https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareAuth.html#named-arguments-options))
+  - `apiConfig` (Object): `AuthMiddleware` options for authentication on the commercetools platform. (Required. See [here](https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareAuth#named-arguments-options))
   - `accessToken` (String): [Access token] to be used to authenticate requests to API. Requires scope of [`view_products`, `manage_products`, `view_orders`, `manage_orders`, `view_payments`, `manage_payments`, `view_shopping_lists`, `manage_shopping_lists`, `view_customers`, `manage_customers`]. More info on how to get the access token [here](https://docs.commercetools.com/api/authorization)
 - An optional logger object having four functions (`info`, `warn`, `error` and `debug`)
 

docs/cli/resource-deleter.md

@@ -29,7 +29,7 @@ Examples of the resources are :
 The constructor accepts two arguments:
 
 - A required object containing the following values:
-  - `apiConfig` (Object): `AuthMiddleware` options for authentication on the commercetools platform. (Required. See [here](https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareAuth.html#named-arguments-options)).
+  - `apiConfig` (Object): `AuthMiddleware` options for authentication on the commercetools platform. (Required. See [here](https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareAuth#named-arguments-options)).
   - `accessToken` (String): [Access token] to be used to authenticate requests to API. Requires scope of [`manage_products`, `manage_customers`, `manage_types`]. More info on how to get the access token [here](https://docs.commercetools.com/api/authorization).
   - `resource` (String): [resource] that need to be deleted.
   - `predicate` (String): Query string specifying (where) predicate. More info on predicates [here](https://docs.commercetools.com/api/predicates/query) (Optional).

docs/sdk/api/typescriptSdk.md

@@ -5,7 +5,7 @@ Follow this [link](https://docs.commercetools.com/sdk/typescript-sdk) for an up
 <!--
 We provide a packages written in typescript for using our API
 
-The **@commercetools/sdk-client-v2** is the TypeScript package that facilitates HTTP [requests](https://commercetools.github.io/nodejs/sdk/Glossary.html#clientrequest) to the Platform, ML or History API by using a predefined set of middlewares.
+The **@commercetools/sdk-client-v2** is the TypeScript package that facilitates HTTP [requests](https://commercetools.github.io/nodejs/sdk/Glossary#clientrequest) to the Platform, ML or History API by using a predefined set of middlewares.
 
 Unlike the Node.js sdk-client, the TypeScript client is a little different in its usage however, they are both very similar in every other aspect and it's also backward compatible with the Nodejs sdk-client.
 
@@ -342,7 +342,7 @@ These are class methods that creates auth middlewares using different authentica
 
 #### withAnonymousSessionFlow(options: _AnonymousAuthMiddlewareOptions_)
 
-Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary.html#middleware) to handle authentication for the [Anonymous Session](https://docs.commercetools.com/http-api-authorization.html#tokens-for-anonymous-sessions) flow of the commercetools Platform API.
+Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary#middleware) to handle authentication for the [Anonymous Session](https://docs.commercetools.com/api/authorization#tokens-for-anonymous-sessions) flow of the commercetools Platform API.
 
 #### Named arguments (options)
 
@@ -379,7 +379,7 @@ const client: Client = new ClientBuilder()
 
 #### withClientCredentialsFlow(options: _AuthMiddlewareOptions_)
 
-Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary.html#middleware) to handle authentication for the Client [Credentials Flow](https://docs.commercetools.com/http-api-authorization.html#client-credentials-flow) of the commercetools platform API.
+Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary#middleware) to handle authentication for the Client [Credentials Flow](https://docs.commercetools.com/api/authorization#client-credentials-flow) of the commercetools platform API.
 
 #### Named arguments (options)
 
@@ -417,7 +417,7 @@ const client: Client = new ClientBuilder()
 
 #### withExistingTokenFlow(authorization: _string_, options: _ExistingTokenMiddlewareOptions_)
 
-Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary.html#middleware) that attaches a provided access token `Authorization` header.
+Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary#middleware) that attaches a provided access token `Authorization` header.
 
 #### Named arguments (authorization, options)
 
@@ -446,7 +446,7 @@ const client: Client = new ClientBuilder()
 
 #### withPasswordFlow(options: _PasswordAuthMiddlewareOptions_)
 
-Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary.html#middleware) to handle authentication for the [Password Flow](https://docs.commercetools.com/http-api-authorization.html#password-flow) of the commercetools platform API.
+Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary#middleware) to handle authentication for the [Password Flow](https://docs.commercetools.com/api/authorization#password-flow) of the commercetools platform API.
 
 #### Named arguments (options)
 
@@ -488,7 +488,7 @@ const client: Client = new ClientBuilder()
 
 #### withRefreshTokenFlow(options: _RefreshAuthMiddlewareOptions_)
 
-Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary.html#middleware) to handle authentication for the Refresh Token Flow of the commercetools platform API.
+Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary#middleware) to handle authentication for the Refresh Token Flow of the commercetools platform API.
 
 #### Named arguments (options)
 
@@ -528,7 +528,7 @@ There are other class methods that creates middlewares used to fully customize a
 
 #### withHttpMiddleware(options: _HttpMiddlewareOptions_)
 
-Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary.html#middleware) to handle HTTP requests for the commercetools platform API.
+Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary#middleware) to handle HTTP requests for the commercetools platform API.
 
 The HTTP middleware can run in either a browser or Node.js environment. For Node.js environments it is important to either have a fetch implementation either globally available via e.g. [isomorphic-fetch](https://github.com/matthew-andrews/isomorphic-fetch) or to pass it in as an argument (see below) via e.g. [node-fetch](https://github.com/bitinn/node-fetch). In browsers without a native fetch implementation any well known fetch polyfill should be compatible with the middleware such as [whatwg-fetch](https://github.com/whatwg/fetch) or [unfetch](https://github.com/developit/unfetch).
 
@@ -623,12 +623,12 @@ This is to ensure that a new instance of the AbortController is always created a
 
 ##### getErrorByCode(code)
 
-Returns a [custom error](https://commercetools.github.io/nodejs/sdk/Glossary.html#httperrortype) type given its status code.
+Returns a [custom error](https://commercetools.github.io/nodejs/sdk/Glossary#httperrortype) type given its status code.
 
 Arguments
 `code` (_Number_): the HTTP status code
 Returns
-(`Error` or `undefined`): A [custom error](https://commercetools.github.io/nodejs/sdk/Glossary.html#httperrortype) type (e.g. `BadRequest`, `Unauthorized`) if the code matches, otherwise `undefined`.
+(`Error` or `undefined`): A [custom error](https://commercetools.github.io/nodejs/sdk/Glossary#httperrortype) type (e.g. `BadRequest`, `Unauthorized`) if the code matches, otherwise `undefined`.
 
 #### Usage example
 
@@ -643,7 +643,7 @@ const error = new ErrorType('Oops')
 
 #### withUserAgentMiddleware()
 
-Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary.html#middleware) to append the `User-Agent` HTTP header to the request.
+Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary#middleware) to append the `User-Agent` HTTP header to the request.
 
 #### Usage example
 
@@ -662,7 +662,7 @@ const client: Client = new ClientBuilder()
 
 #### withCorrelationIdMiddleware(options: _CorrelationIdMiddlewareOptions_)
 
-Creates a middleware to add a correlation ID to executed [requests](https://commercetools.github.io/nodejs/sdk/Glossary.html#clientrequest).
+Creates a middleware to add a correlation ID to executed [requests](https://commercetools.github.io/nodejs/sdk/Glossary#clientrequest).
 
 #### Usage example
 
@@ -683,7 +683,7 @@ const client: Client = new ClientBuilder()
 
 #### withQueueMiddleware(options: _QueueMiddlewareOptions_)
 
-Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary.html#middleware) to handle concurrent requests.
+Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary#middleware) to handle concurrent requests.
 
 #### Named arguments (options)
 
@@ -707,7 +707,7 @@ const client: Client = new ClientBuilder()
 
 #### withLoggerMiddleware()
 
-Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary.html#middleware) to log request and response objects being executed.
+Creates a [middleware](https://commercetools.github.io/nodejs/sdk/Glossary#middleware) to log request and response objects being executed.
 
 #### Usage Example
 

packages/api-request-builder/README.md

@@ -2,7 +2,7 @@
 
 Helper functions collection to easily construct API requests URI in a declarative way, for usage with `@commercetools/sdk-client`.
 
-https://commercetools.github.io/nodejs/sdk/api/apiRequestBuilder.html
+https://commercetools.github.io/nodejs/sdk/api/apiRequestBuilder
 
 ## Install
 

packages/get-credentials/package.json

@@ -16,7 +16,7 @@
     "type": "git",
     "url": "https://github.com/commercetools/nodejs/tree/master/packages/get-credentials"
   },
-  "homepage": "https://commercetools.github.io/nodejs/sdk/api/getCredentials.html",
+  "homepage": "https://commercetools.github.io/nodejs/sdk/api/getCredentials",
   "bugs": "https://github.com/commercetools/nodejs/issues",
   "license": "MIT",
   "contributors": [

packages/get-credentials/readme.md

@@ -12,7 +12,7 @@
 
 Retrieve commercetools platform credentials from environment variables or file system.
 
-https://commercetools.github.io/nodejs/sdk/api/getCredentials.html
+https://commercetools.github.io/nodejs/sdk/api/getCredentials
 
 ## Install
 

packages/http-user-agent/README.md

@@ -12,7 +12,7 @@
 
 Creates a proper HTTP User-Agent
 
-https://commercetools.github.io/nodejs/sdk/api/httpUserAgent.html
+https://commercetools.github.io/nodejs/sdk/api/httpUserAgent
 
 ## Install
 

packages/personal-data-erasure/package.json

@@ -18,7 +18,7 @@
     "type": "git",
     "url": "https://github.com/commercetools/nodejs/tree/master/packages/personal-data-erasure"
   },
-  "homepage": "https://commercetools.github.io/nodejs/cli/personal-data-erasure.html",
+  "homepage": "https://commercetools.github.io/nodejs/cli/personal-data-erasure",
   "bugs": "https://github.com/commercetools/nodejs/issues",
   "keywords": [
     "commercetools",

packages/resource-deleter/package.json

@@ -18,7 +18,7 @@
     "type": "git",
     "url": "https://github.com/commercetools/nodejs/tree/master/packages/resource-deleter"
   },
-  "homepage": "https://commercetools.github.io/nodejs/cli/resource-deleter.html",
+  "homepage": "https://commercetools.github.io/nodejs/cli/resource-deleter",
   "bugs": "https://github.com/commercetools/nodejs/issues",
   "keywords": [
     "commercetools",

packages/resource-deleter/readme.md

@@ -2,7 +2,7 @@
 
 Deletes commercetools resources from the commercetools platform.
 
-More info here: https://commercetools.github.io/nodejs/cli/resource-deleter.html
+More info here: https://commercetools.github.io/nodejs/cli/resource-deleter
 
 ## Install
 

packages/sdk-auth/README.md

@@ -12,7 +12,7 @@
 
 Auth module for working with commercetools platform API
 
-https://commercetools.github.io/nodejs/sdk/api/sdkAuth.html
+https://commercetools.github.io/nodejs/sdk/api/sdkAuth
 
 ## Install
 

packages/sdk-client/README.md

@@ -12,7 +12,7 @@
 
 SDK Client for usage of commercetools platform API
 
-https://commercetools.github.io/nodejs/sdk/api/sdkClient.html
+https://commercetools.github.io/nodejs/sdk/api/sdkClient
 
 ## Note:
 

packages/sdk-client/src/client.js

@@ -88,7 +88,7 @@ export default function createClient(options: ClientOptions): Client {
       if (typeof fn !== 'function')
         // eslint-disable-next-line max-len
         throw new Error(
-          'The "process" function accepts a "Function" as a second argument that returns a Promise. See https://commercetools.github.io/nodejs/sdk/api/sdkClient.html#processrequest-processfn-options'
+          'The "process" function accepts a "Function" as a second argument that returns a Promise. See https://commercetools.github.io/nodejs/sdk/api/sdkClient#processrequest-processfn-options'
         )
 
       // Set default process options

packages/sdk-client/src/validate.js

@@ -8,18 +8,18 @@ export default function validate(
   if (!request)
     // eslint-disable-next-line max-len
     throw new Error(
-      `The "${funcName}" function requires a "Request" object as an argument. See https://commercetools.github.io/nodejs/sdk/Glossary.html#clientrequest`
+      `The "${funcName}" function requires a "Request" object as an argument. See https://commercetools.github.io/nodejs/sdk/Glossary#clientrequest`
     )
 
   if (typeof request.uri !== 'string')
     // eslint-disable-next-line max-len
     throw new Error(
-      `The "${funcName}" Request object requires a valid uri. See https://commercetools.github.io/nodejs/sdk/Glossary.html#clientrequest`
+      `The "${funcName}" Request object requires a valid uri. See https://commercetools.github.io/nodejs/sdk/Glossary#clientrequest`
     )
 
   if (!options.allowedMethods.includes(request.method))
     // eslint-disable-next-line max-len
     throw new Error(
-      `The "${funcName}" Request object requires a valid method. See https://commercetools.github.io/nodejs/sdk/Glossary.html#clientrequest`
+      `The "${funcName}" Request object requires a valid method. See https://commercetools.github.io/nodejs/sdk/Glossary#clientrequest`
     )
 }

packages/sdk-middleware-auth/README.md

@@ -12,7 +12,7 @@
 
 Auth middlewares collection for usage with `@commercetools/sdk-client`
 
-https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareAuth.html
+https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareAuth
 
 ### Install
 

packages/sdk-middleware-correlation-id/README.md

@@ -12,7 +12,7 @@
 
 Middleware for adding a correlation id to requests with `@commercetools/sdk-client`
 
-https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareCorrelationId.html
+https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareCorrelationId
 
 ## Install
 

packages/sdk-middleware-http/README.md

@@ -12,7 +12,7 @@
 
 Middleware for making http requests for usage with `@commercetools/sdk-client`
 
-https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareHttp.html
+https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareHttp
 
 ## Install
 

packages/sdk-middleware-logger/README.md

@@ -12,7 +12,7 @@
 
 Middleware for queueing requests for usage with `@commercetools/sdk-client`
 
-https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareLogger.html
+https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareLogger
 
 ## Install
 

packages/sdk-middleware-queue/README.md

@@ -12,7 +12,7 @@
 
 Middleware for queueing requests for usage with `@commercetools/sdk-client`
 
-https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareQueue.html
+https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareQueue
 
 ## Install
 

packages/sdk-middleware-user-agent/README.md

@@ -12,7 +12,7 @@
 
 Middleware for setting the User-Agent on the HTTP request for usage with `@commercetools/sdk-client`
 
-https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareUserAgent.html
+https://commercetools.github.io/nodejs/sdk/api/sdkMiddlewareUserAgent
 
 ## Install
 

packages/sync-actions/README.md

@@ -2,7 +2,7 @@
 
 Construct API update actions, for usage with `@commercetools/sdk-client`.
 
-https://commercetools.github.io/nodejs/sdk/api/syncActions.html
+https://commercetools.github.io/nodejs/sdk/api/syncActions
 
 ## Install
 

packages/sync-actions/src/types-actions.js

@@ -201,7 +201,7 @@ export function actionsMapFieldDefinitions(
   // Make sure to execute removeActions before creating new ones
   // in order to prevent any eventual removal of `addAction`.
   // List of `removeActions` can be found here
-  // https://docs.commercetools.com/http-api-projects-types.html#change-key
+  // https://docs.commercetools.com/api/projects/types#change-key
   const sortedActions = sortBy(
     actions,
     (action) => action.action !== 'removeFieldDefinition'

packages/sync-actions/test/product-types-sync-attribute-hints.spec.js

@@ -238,7 +238,7 @@ describe('product type hints', () => {
                 newValue: {
                   key: 'next-enum-draft-item',
                   // this is a possibility on clients. we ought to rely on the API, to return an error
-                  // ref: https://docs.commercetools.com/http-api-projects-productTypes.html#change-the-label-of-an-enumvalue
+                  // ref: https://docs.commercetools.com/api/projects/productTypes#change-the-label-of-an-enumvalue
                   label: undefined,
                 },
               },