fix(#2417): fix broken guides links

CHANGELOG.md

@@ -20,6 +20,7 @@ changes.
 - Fix inconsistent voting status [Issue 1713](https://github.com/IntersectMBO/govtool/issues/1713)
 - Fix removing a child (link) when is not registed in DOM [Issue 2398](https://github.com/IntersectMBO/govtool/issues/2398)
 - Fix blank screen on DRep delegation when UTXos are missing [Issue 2408](https://github.com/IntersectMBO/govtool/issues/2408)
+- Fix broken guides links [Issue 2417](https://github.com/IntersectMBO/govtool/issues/2417)
 
 ### Changed
 

README.md

@@ -36,7 +36,7 @@ The Cardano GovTool enables ada holders to experience the governance features de
 
 ### Documentation
 
-Learn more; [docs.gov.tools](https://docs.gov.tools/).
+Learn more; [docs.gov.tools](https://docs.gov.tools/cardano-govtool/using-govtool).
 
 ## 📍 Navigation
 

docs/architecture/README.md

@@ -23,7 +23,7 @@ utility backend that serves validation of the governance actions metadata.
 
 # Description
 
-Frontend is a React application using Vite as a built tool to enhance development speed and optimize production builds. Frontend interacts with the backend service via REST API and with the Cardano blockchain via cardano-serialization-lib and connected supported wallets (for the list of compatible wallets go [here](https://docs.gov.tools/how-to-use-the-govtool/getting-started/get-a-compatible-wallet)).
+Frontend is a React application using Vite as a built tool to enhance development speed and optimize production builds. Frontend interacts with the backend service via REST API and with the Cardano blockchain via cardano-serialization-lib and connected supported wallets (for the list of compatible wallets go [here](https://docs.gov.tools/cardano-govtool/using-govtool/getting-started/compatible-wallets)).
 
 # Components
 

govtool/frontend/src/components/molecules/DataMissingInfoBox.tsx

@@ -4,6 +4,7 @@ import { Typography } from "@atoms";
 import { useTranslation } from "@hooks";
 import { MetadataValidationStatus } from "@models";
 import { openInNewTab } from "@utils";
+import { LINKS } from "@/consts/links";
 
 export const DataMissingInfoBox = ({
   isDataMissing,
@@ -78,11 +79,7 @@ export const DataMissingInfoBox = ({
         {gaMetadataErrorDescription}
       </Typography>
       <Link
-        onClick={() =>
-          openInNewTab(
-            "https://docs.gov.tools/using-govtool/govtool-functions/dreps/drep-error-conditions",
-          )
-        }
+        onClick={() => openInNewTab(LINKS.DREP_ERROR_CONDITIONS)}
         sx={{
           fontFamily: "Poppins",
           fontSize: "16px",

govtool/frontend/src/components/organisms/AutomatedVotingOptions.tsx

@@ -16,6 +16,7 @@ import {
   AutomatedVotingOptionCurrentDelegation,
   AutomatedVotingOptionDelegationId,
 } from "@/types/automatedVotingOptions";
+import { LINKS } from "@/consts/links";
 
 type AutomatedVotingOptionsProps = {
   currentDelegation?: string | null;
@@ -118,11 +119,7 @@ export const AutomatedVotingOptions = ({
             onClickDelegate={() =>
               delegate(AutomatedVotingOptionDelegationId.abstain)
             }
-            onClickInfo={() =>
-              openInNewTab(
-                "https://docs.gov.tools/using-govtool/govtool-functions/delegating/abstain-from-every-vote",
-              )
-            }
+            onClickInfo={() => openInNewTab(LINKS.ABSTAIN_FROM_EVERY_VOTE)}
             title={
               isDelegatedToAbstain
                 ? t("dRepDirectory.delegatedToAbstainTitle", {
@@ -162,9 +159,7 @@ export const AutomatedVotingOptions = ({
               delegate(AutomatedVotingOptionDelegationId.no_confidence)
             }
             onClickInfo={() =>
-              openInNewTab(
-                "https://docs.gov.tools/using-govtool/govtool-functions/delegating/signal-no-confidence-on-every-vote",
-              )
+              openInNewTab(LINKS.SIGNAL_NO_CONFIDENCE_ON_EVERY_VOTE)
             }
             title={
               isDelegatedToNoConfidence

govtool/frontend/src/components/organisms/CreateGovernanceActionSteps/StorageInformation.tsx

@@ -17,6 +17,7 @@ import {
   isValidURLLength,
   openInNewTab,
 } from "@utils";
+import { LINKS } from "@/consts/links";
 
 type StorageInformationProps = {
   setStep: Dispatch<SetStateAction<number>>;
@@ -39,9 +40,7 @@ export const StorageInformation = ({ setStep }: StorageInformationProps) => {
   const fileName = getValues("governance_action_type") as string;
 
   const openGuideAboutStoringInformation = () =>
-    openInNewTab(
-      "https://docs.gov.tools/using-govtool/govtool-functions/storing-information-offline",
-    );
+    openInNewTab(LINKS.STORING_INFORMATION_OFFLINE);
 
   const isActionButtonDisabled = !watch("storingURL") || !!errors.storingURL;
 

govtool/frontend/src/components/organisms/CreateGovernanceActionSteps/StoreDataInfo.tsx

@@ -10,6 +10,7 @@ import {
 import { CenteredBoxBottomButtons } from "@molecules";
 import { ControlledField } from "@organisms";
 import { openInNewTab } from "@utils";
+import { LINKS } from "@/consts/links";
 
 type StoreDataInfoProps = {
   setStep: Dispatch<SetStateAction<number>>;
@@ -20,10 +21,7 @@ export const StoreDataInfo = ({ setStep }: StoreDataInfoProps) => {
   const { control, errors, watch } = useCreateGovernanceActionForm();
   const { isMobile } = useScreenDimension();
 
-  const openLink = () =>
-    openInNewTab(
-      "https://docs.gov.tools/using-govtool/govtool-functions/storing-information-offline",
-    );
+  const openLink = () => openInNewTab(LINKS.STORING_INFORMATION_OFFLINE);
 
   const isContinueDisabled = !watch("storeData");
 

govtool/frontend/src/components/organisms/DashboardCards/DRepDashboardCard.tsx

@@ -11,6 +11,7 @@ import {
   DashboardActionCardProps,
 } from "@molecules";
 import { correctAdaFormat, openInNewTab } from "@utils";
+import { LINKS } from "@/consts/links";
 
 type DRepDashboardCardProps = {
   dRepID: string;
@@ -37,10 +38,7 @@ export const DRepDashboardCard = ({
   const learnMoreButton = {
     children: t("learnMore"),
     dataTestId: "d-rep-learn-more-button",
-    onClick: () =>
-      openInNewTab(
-        "https://docs.gov.tools/using-govtool/govtool-functions/dreps/register-as-a-drep",
-      ),
+    onClick: () => openInNewTab(LINKS.REGISTER_AS_A_DREP),
   };
 
   const navigateToDrepDirectory = () => {
@@ -130,10 +128,7 @@ export const DRepDashboardCard = ({
           ? {
               children: t("learnMore"),
               dataTestId: "register-learn-more-button",
-              onClick: () =>
-                openInNewTab(
-                  "https://docs.gov.tools/using-govtool/govtool-functions/dreps/retire-as-a-drep",
-                ),
+              onClick: () => openInNewTab(LINKS.RETIRE_AS_A_DREP),
             }
           : learnMoreButton,
       ];

govtool/frontend/src/components/organisms/DashboardCards/DelegateDashboardCard.tsx

@@ -20,6 +20,7 @@ import {
   AutomatedVotingOptionCurrentDelegation,
   AutomatedVotingOptionDelegationId,
 } from "@/types/automatedVotingOptions";
+import { LINKS } from "@/consts/links";
 
 type DelegateDashboardCardProps = {
   currentDelegation: CurrentDelegation;
@@ -45,10 +46,7 @@ export const DelegateDashboardCard = ({
   const learnMoreButton = {
     children: t("learnMore"),
     dataTestId: "delegate-learn-more-button",
-    onClick: () =>
-      openInNewTab(
-        "https://docs.gov.tools/how-to-use-the-govtool/using-govtool/delegating",
-      ),
+    onClick: () => openInNewTab(LINKS.DELEGATING),
     sx: { backgroundColor: "arcticWhite" },
   };
 

govtool/frontend/src/components/organisms/DashboardCards/DirectVoterDashboardCard.tsx

@@ -8,6 +8,7 @@ import { useTranslation } from "@hooks";
 import { VoterInfo } from "@models";
 import { DashboardActionCard, DashboardActionCardProps } from "@molecules";
 import { correctAdaFormat, openInNewTab } from "@utils";
+import { LINKS } from "@/consts/links";
 
 type DirectVoterDashboardCardProps = {
   pendingTransaction: PendingTransaction;
@@ -29,10 +30,7 @@ export const DirectVoterDashboardCard = ({
   const learnMoreButton: LoadingButtonProps = {
     children: t("learnMore"),
     dataTestId: "direct-voter-learn-more-button",
-    onClick: () =>
-      openInNewTab(
-        "https://docs.gov.tools/using-govtool/govtool-functions/direct-voting",
-      ),
+    onClick: () => openInNewTab(LINKS.DIRECT_VOTING),
   };
 
   const cardProps: Partial<DashboardActionCardProps> = (() => {
@@ -96,10 +94,7 @@ export const DirectVoterDashboardCard = ({
           {
             children: t("learnMore"),
             dataTestId: "learn-more-button",
-            onClick: () =>
-              openInNewTab(
-                "https://docs.gov.tools/using-govtool/govtool-functions/direct-voting",
-              ),
+            onClick: () => openInNewTab(LINKS.DIRECT_VOTING),
           },
         ],
         description: (

govtool/frontend/src/components/organisms/DashboardCards/ListGovActionsDashboardCard.tsx

@@ -4,6 +4,7 @@ import { IMAGES, PATHS } from "@consts";
 import { useTranslation } from "@hooks";
 import { DashboardActionCard } from "@molecules";
 import { openInNewTab } from "@utils";
+import { LINKS } from "@/consts/links";
 
 export const ListGovActionsDashboardCards = () => {
   const navigate = useNavigate();
@@ -21,10 +22,7 @@ export const ListGovActionsDashboardCards = () => {
         {
           children: t("learnMore"),
           dataTestId: "list-gov-actions-learn-more-button",
-          onClick: () =>
-            openInNewTab(
-              "https://docs.gov.tools/using-govtool/govtool-functions/governance-actions/view-governance-actions",
-            ),
+          onClick: () => openInNewTab(LINKS.VIEW_GOVERNANCE_ACTIONS),
           variant: "outlined",
         },
       ]}

govtool/frontend/src/components/organisms/DashboardCards/ProposeGovActionDashboardCard.tsx

@@ -6,6 +6,7 @@ import { useTranslation } from "@hooks";
 import { DashboardActionCard } from "@molecules";
 import { openInNewTab } from "@utils";
 import { useCallback } from "react";
+import { LINKS } from "@/consts/links";
 
 type ProposeGovActionDashboardCardProps = {
   createGovActionTx: PendingTransaction["createGovAction"];
@@ -52,10 +53,7 @@ export const ProposeGovActionDashboardCard = ({
         {
           children: t("learnMore"),
           dataTestId: "propose-gov-action-learn-more-button",
-          onClick: () =>
-            openInNewTab(
-              "https://docs.gov.tools/using-govtool/govtool-functions/governance-actions/propose-a-governance-action",
-            ),
+          onClick: () => openInNewTab(LINKS.PROPOSE_A_GOVERNANCE_ACTION),
         },
       ]}
       description={t("dashboard.cards.proposeGovernanceAction.description")}

govtool/frontend/src/components/organisms/DrawerMobile.tsx

@@ -7,6 +7,7 @@ import { useFeatureFlag, useModal } from "@context";
 import { openInNewTab } from "@utils";
 
 import { DrawerMobileProps } from "./types";
+import { LINKS } from "@/consts/links";
 
 const DRAWER_PADDING = 2;
 const CALCULATED_DRAWER_PADDING = DRAWER_PADDING * 8 * 2;
@@ -21,10 +22,7 @@ export const DrawerMobile = ({
   const { openModal } = useModal();
   const { t } = useTranslation();
 
-  const onClickHelp = () =>
-    openInNewTab(
-      "https://docs.gov.tools/using-govtool/support#for-support-you-can-reach-the-team-on-the-intersect-discord-server-at",
-    );
+  const onClickHelp = () => openInNewTab(LINKS.SUPPORT);
 
   return (
     <SwipeableDrawer

govtool/frontend/src/components/organisms/EditDRepInfoSteps/EditDRepStorageInformation.tsx

@@ -12,6 +12,7 @@ import {
 import { CenteredBoxBottomButtons, Step } from "@molecules";
 import { ControlledField } from "@organisms";
 import { ellipsizeText, openInNewTab } from "@utils";
+import { LINKS } from "@/consts/links";
 
 type StorageInformationProps = {
   setStep: Dispatch<SetStateAction<number>>;
@@ -35,9 +36,7 @@ export const EditDRepStorageInformation = ({
 
   const fileName = getValues("givenName");
   const openGuideAboutStoringInformation = () =>
-    openInNewTab(
-      "https://docs.gov.tools/using-govtool/govtool-functions/storing-information-offline",
-    );
+    openInNewTab(LINKS.STORING_INFORMATION_OFFLINE);
 
   const isActionButtonDisabled = !watch("storingURL") || !!errors.storingURL;
 

govtool/frontend/src/components/organisms/EditDRepInfoSteps/EditDRepStoreDataInfo.tsx

@@ -11,6 +11,7 @@ import {
 import { openInNewTab } from "@utils";
 
 import { ControlledField } from "..";
+import { LINKS } from "@/consts/links";
 
 export const EditDRepStoreDataInfo = ({
   setStep,
@@ -27,10 +28,7 @@ export const EditDRepStoreDataInfo = ({
 
   const isContinueDisabled = !watch("storeData");
 
-  const openLink = () =>
-    openInNewTab(
-      "https://docs.gov.tools/using-govtool/govtool-functions/storing-information-offline",
-    );
+  const openLink = () => openInNewTab(LINKS.STORING_INFORMATION_OFFLINE);
 
   return (
     <>

govtool/frontend/src/components/organisms/Footer.tsx

@@ -5,6 +5,7 @@ import { ICONS } from "@consts";
 import { useUsersnapApi } from "@context";
 import { useScreenDimension, useTranslation } from "@hooks";
 import { openInNewTab, testIdFromLabel } from "@utils";
+import { LINKS } from "@/consts/links";
 
 type FooterLinkProps = {
   label: string;
@@ -34,10 +35,7 @@ export const Footer = () => {
   const { t } = useTranslation();
   const { openFeedbackWindow } = useUsersnapApi();
 
-  const onClickHelp = () =>
-    openInNewTab(
-      "https://docs.gov.tools/using-govtool/support#for-support-you-can-reach-the-team-on-the-intersect-discord-server-at",
-    );
+  const onClickHelp = () => openInNewTab(LINKS.SUPPORT);
 
   const onClickPrivacyPolicy = () =>
     openInNewTab(

govtool/frontend/src/components/organisms/HomeCards.tsx

@@ -7,6 +7,7 @@ import { useFeatureFlag, useModal } from "@context";
 import { ActionCard } from "@molecules";
 import { useTranslation } from "@hooks";
 import { openInNewTab } from "@utils";
+import { LINKS } from "@/consts/links";
 
 export const HomeCards = () => {
   const { isProposalDiscussionForumEnabled } = useFeatureFlag();
@@ -26,25 +27,16 @@ export const HomeCards = () => {
     [openModal],
   );
 
-  const onClickLearnMoreAboutDelegation = () =>
-    openInNewTab(
-      "https://docs.gov.tools/how-to-use-the-govtool/using-govtool/delegating",
-    );
+  const onClickLearnMoreAboutDelegation = () => openInNewTab(LINKS.DELEGATING);
 
   const onClickLearnMoreAboutDRepRegistration = () =>
-    openInNewTab(
-      "https://docs.gov.tools/using-govtool/govtool-functions/dreps/register-as-a-drep",
-    );
+    openInNewTab(LINKS.REGISTER_AS_A_DREP);
 
   const onClickLearnMoreAboutDirectVoterRegistration = () =>
-    openInNewTab(
-      "https://docs.gov.tools/using-govtool/govtool-functions/direct-voting",
-    );
+    openInNewTab(LINKS.DIRECT_VOTING);
 
   const onClickLearnMoreAboutProposingGovAction = () =>
-    openInNewTab(
-      "https://docs.gov.tools/using-govtool/govtool-functions/governance-actions/governance-actions/propose-a-governance-action",
-    );
+    openInNewTab(LINKS.PROPOSE_A_GOVERNANCE_ACTION);
 
   const navigateToGovActions = useCallback(
     () => navigate(PATHS.governanceActions),

govtool/frontend/src/components/organisms/Modal/ChooseWalletModal.tsx

@@ -8,6 +8,7 @@ import { WalletOptionButton } from "@molecules";
 import { openInNewTab } from "@utils";
 import { useTranslation } from "@hooks";
 import { To } from "react-router-dom";
+import { LINKS } from "@/consts/links";
 
 type ChooseWalletModalState = {
   pathToNavigate?: To;
@@ -105,11 +106,7 @@ export const ChooseWalletModal = forwardRef<HTMLDivElement>((_, ref) => {
           <Link
             fontSize={11}
             fontWeight={500}
-            onClick={() =>
-              openInNewTab(
-                "https://docs.gov.tools/how-to-use-the-govtool/getting-started/get-a-compatible-wallet",
-              )
-            }
+            onClick={() => openInNewTab(LINKS.COMPATIBLE_WALLETS)}
             sx={{ cursor: "pointer" }}
           >
             {t("here")}

govtool/frontend/src/components/organisms/RegisterAsDRepSteps/DRepStorageInformation.tsx

@@ -12,6 +12,7 @@ import {
 import { CenteredBoxBottomButtons, Step } from "@molecules";
 import { ControlledField } from "@organisms";
 import { openInNewTab, ellipsizeText } from "@utils";
+import { LINKS } from "@/consts/links";
 
 type StorageInformationProps = {
   setStep: Dispatch<SetStateAction<number>>;
@@ -36,9 +37,7 @@ export const DRepStorageInformation = ({
   const fileName = getValues("givenName");
 
   const openGuideAboutStoringInformation = () =>
-    openInNewTab(
-      "https://docs.gov.tools/using-govtool/govtool-functions/storing-information-offline",
-    );
+    openInNewTab(LINKS.STORING_INFORMATION_OFFLINE);
 
   const isActionButtonDisabled = !watch("storingURL") || !!errors.storingURL;