fix: update docs link for IP ranges (#5608)

- Updated docs link for IP ranges
- Added verbose error message for redirects

Author: ndv99

src/app/base/docsUrls.ts

@@ -14,7 +14,7 @@ const docsUrls = {
   dhcp: "https://maas.io/docs/about-dhcp-in-maas",
   ipmi: "https://maas.io/docs/reference-power-drivers#p-17434-ipmi",
   ipRanges:
-    "https://maas.io/docs/how-to-customise-dhcp#p-9038-edit-delete-or-extend-ip-range",
+    "https://maas.io/docs/how-to-customise-maas-networks#p-9070-create-ips-and-ranges",
   kvmIntroduction: "https://maas.io/docs/how-to-use-lxd-vms",
   networkDiscovery:
     "https://maas.io/docs/how-to-customise-maas-networks#p-9070-manage-network-discovery",

tests/docs-links.spec.ts

@@ -3,6 +3,17 @@ import docsUrls from "../src/app/base/docsUrls";
 
 const urls = Object.values(docsUrls);
 
+const redirectErrorMessage = (url: string, location: string | null) => `
+  URL NEEDS TO BE UPDATED
+  -----------------------------
+  FROM:
+  ${url}
+  
+  TO:
+  https://maas.io${location}
+  
+  `;
+
 test.describe("loads the page", () => {
   urls.forEach((url) => {
     test(`${url}`, async () => {
@@ -16,9 +27,13 @@ test.describe("loads the page", () => {
 test.describe("is a direct link", () => {
   urls.forEach((url) => {
     test(`${url}`, async () => {
+      // prevent auto redirect so we can get the HTTP 302 if present
       const docsPage = fetch(url, { redirect: "manual" });
-      const resCode = await docsPage.then((res) => res.status);
-      expect(resCode).toBe(200);
+      const { status, headers } = await docsPage.then((res) => res);
+
+      expect(status, redirectErrorMessage(url, headers.get("location"))).toBe(
+        200
+      );
     });
   });
 });