quiltdata · nl0 · Nov 19, 2024 · Oct 30, 2024 · Oct 30, 2024 · Oct 30, 2024
diff --git a/catalog/CHANGELOG.md b/catalog/CHANGELOG.md
@@ -17,6 +17,7 @@ where verb is one of
 
 ## Changes
 
+- [Fixed] Fix some doc URLs in catalog ([#4205](https://github.com/quiltdata/quilt/pull/4205))
 - [Changed] S3 Select -> GQL API calls for getting access counts ([#4218](https://github.com/quiltdata/quilt/pull/4218))
 - [Changed] Athena: improve loading state and errors visuals; fix minor bugs; alphabetize and persist selection in workgroups, catalog names and databases ([#4208](https://github.com/quiltdata/quilt/pull/4208))
 - [Changed] Show stack release version in footer ([#4200](https://github.com/quiltdata/quilt/pull/4200))

diff --git a/catalog/app/components/FileEditor/QuiltConfigEditor/BucketPreferences.tsx b/catalog/app/components/FileEditor/QuiltConfigEditor/BucketPreferences.tsx
@@ -12,7 +12,10 @@ function Header() {
   return (
     <M.Typography variant="body2">
       Configuration for Catalog UI: show and hide features, set default values. See{' '}
-      <StyledLink href={`${docs}/catalog/preferences`} target="_blank">
+      <StyledLink
+        href={`${docs}/quilt-platform-administrator/preferences`}
+        target="_blank"
+      >
         the docs
       </StyledLink>
     </M.Typography>

diff --git a/catalog/app/components/FileEditor/QuiltConfigEditor/Workflows.tsx b/catalog/app/components/FileEditor/QuiltConfigEditor/Workflows.tsx
@@ -18,7 +18,7 @@ function Header() {
   return (
     <M.Typography variant="body2">
       Configuration for data quality workflows. See{' '}
-      <StyledLink href={`${docs}/advanced/workflows`} target="_blank">
+      <StyledLink href={`${docs}/workflows`} target="_blank">
         the docs
       </StyledLink>
     </M.Typography>

diff --git a/catalog/app/containers/Admin/Status/Status.tsx b/catalog/app/containers/Admin/Status/Status.tsx
@@ -54,7 +54,10 @@ export default function Status() {
               GxP and other compliance regimes.
             </M.Typography>
             <M.Typography align="center">
-              <StyledLink href={`${docs}/advanced/good-practice`} target="_blank">
+              <StyledLink
+                href={`${docs}/quilt-platform-administrator/best-practices/good-practice`}
+                target="_blank"
+              >
                 Learn more
               </StyledLink>{' '}
               or <StyledLink href="mailto:[email protected]">contact sales</StyledLink>.

diff --git a/catalog/app/containers/Admin/UsersAndRoles/SsoConfig.tsx b/catalog/app/containers/Admin/UsersAndRoles/SsoConfig.tsx
@@ -121,7 +121,10 @@ function Form({
             <FormError error={error || submitError} errors={FORM_ERRORS} />
             <M.Typography variant="body2">
               Learn more about{' '}
-              <StyledLink href={`${docs}/advanced/sso-permissions`} target="_blank">
+              <StyledLink
+                href={`${docs}/quilt-platform-administrator/advanced/sso-permissions`}
+                target="_blank"
+              >
                 SSO permissions mapping
               </StyledLink>
               .

diff --git a/catalog/app/containers/Bucket/CodeSamples/Dir.tsx b/catalog/app/containers/Bucket/CodeSamples/Dir.tsx
@@ -14,9 +14,9 @@ const TEMPLATES = {
     dedent`
       import quilt3 as q3
       b = q3.Bucket("s3://${bucket}")
-      # List files [[${docs}/api-reference/bucket#bucket.ls]]
+      # List files [[${docs}/quilt-python-sdk-developers/api-reference/bucket#bucket.ls]]
       b.ls("${path}")
-      # Download [[${docs}/api-reference/bucket#bucket.fetch]]
+      # Download [[${docs}/quilt-python-sdk-developers/api-reference/bucket#bucket.fetch]]
       b.fetch("${path}", "./${dest}")
     `,
   CLI: (bucket: string, path: string, dest: string) =>

diff --git a/catalog/app/containers/Bucket/CodeSamples/File.tsx b/catalog/app/containers/Bucket/CodeSamples/File.tsx
@@ -14,7 +14,7 @@ const TEMPLATES = {
     dedent`
       import quilt3 as q3
       b = q3.Bucket("s3://${bucket}")
-      # Download [[${docs}/api-reference/bucket#bucket.fetch]]
+      # Download [[${docs}/quilt-python-sdk-developers/api-reference/bucket#bucket.fetch]]
       b.fetch("${path}", "./${basename(path)}")
     `,
   CLI: (bucket: string, path: string) =>

diff --git a/catalog/app/containers/Bucket/CodeSamples/Package.tsx b/catalog/app/containers/Bucket/CodeSamples/Package.tsx
@@ -19,30 +19,30 @@ const TEMPLATES = {
     const hashPy = hashDisplay && `, top_hash="${hashDisplay}"`
     return dedent`
       import quilt3 as q3
-      # Browse [[${docs}/api-reference/package#package.browse]]
+      # Browse [[${docs}/quilt-python-sdk-developers/api-reference/package#package.browse]]
       p = q3.Package.browse("${name}"${hashPy}, registry="s3://${bucket}")
-      # make changes to package adding individual files [[${docs}/api-reference/package#package.set]]
+      # make changes to package adding individual files [[${docs}/quilt-python-sdk-developers/api-reference/package#package.set]]
       p.set("data.csv", "data.csv")
-      # or whole directories [[${docs}/api-reference/package#package.set_dir]]
+      # or whole directories [[${docs}/quilt-python-sdk-developers/api-reference/package#package.set_dir]]
       p.set_dir("subdir", "subdir")
-      # and push changes [[${docs}/api-reference/package#package.push]]
+      # and push changes [[${docs}/quilt-python-sdk-developers/api-reference/package#package.push]]
       p.push("${name}", registry="s3://${bucket}", message="Hello World")
 
-      # Download (be mindful of large packages) [[${docs}/api-reference/package#package.push]]
+      # Download (be mindful of large packages) [[${docs}/quilt-python-sdk-developers/api-reference/package#package.install]]
       q3.Package.install("${name}"${pathPy}${hashPy}, registry="s3://${bucket}", dest=".")
     `
   },
   CLI_DOWNLOAD: (bucket: string, name: string, path: string, hashDisplay: string) => {
     const pathCli = path && ` --path "${s3paths.ensureNoSlash(path)}"`
     const hashCli = hashDisplay && ` --top-hash ${hashDisplay}`
     return dedent`
-      # Download package [[${docs}/api-reference/cli#install]]
+      # Download package [[${docs}/quilt-python-sdk-developers/api-reference/cli#install]]
       quilt3 install "${name}"${pathCli}${hashCli} --registry s3://${bucket} --dest .
     `
   },
   CLI_UPLOAD: (bucket: string, name: string) =>
     dedent`
-      # Upload package [[${docs}/api-reference/cli#push]]
+      # Upload package [[${docs}/quilt-python-sdk-developers/api-reference/cli#push]]
       echo "Hello World" > README.md
       quilt3 push "${name}" --registry s3://${bucket} --dir .
     `,

diff --git a/catalog/app/containers/Bucket/PackageDialog/DialogError.tsx b/catalog/app/containers/Bucket/PackageDialog/DialogError.tsx
@@ -42,7 +42,7 @@ const errorDisplay = R.cond([
           Please fix the{' '}
           <WorkflowsConfigLink bucket={bucket}>workflows config</WorkflowsConfigLink>{' '}
           according to{' '}
-          <StyledLink href={`${docs}/advanced/workflows`} target="_blank">
+          <StyledLink href={`${docs}/workflows`} target="_blank">
             the documentation
           </StyledLink>
           .

diff --git a/catalog/app/containers/Bucket/PackageDialog/SelectWorkflow.tsx b/catalog/app/containers/Bucket/PackageDialog/SelectWorkflow.tsx
@@ -71,7 +71,7 @@ export default function SelectWorkflow({
       </M.Select>
       <M.FormHelperText>
         {!!error && <span className={classes.error}>{error}</span>}
-        <M.Link href={`${docs}/advanced/workflows`} target="_blank">
+        <M.Link href={`${docs}/workflows`} target="_blank">
           Learn about data quality workflows
         </M.Link>
         , or edit{' '}

diff --git a/catalog/app/containers/Bucket/Queries/Athena/Workgroups.tsx b/catalog/app/containers/Bucket/Queries/Athena/Workgroups.tsx
@@ -97,8 +97,10 @@ function WorkgroupsEmpty({ error }: WorkgroupsEmptyProps) {
       <M.Box mt={1}>
         <M.Typography variant="body2">
           Check{' '}
-          <StyledLink href={`${docs}/advanced/athena`}>Athena Queries docs</StyledLink> on
-          setup and correct usage
+          <StyledLink href={`${docs}/quilt-platform-catalog-user/advanced/athena`}>
+            Athena Queries docs
+          </StyledLink>{' '}
+          on setup and correct usage
         </M.Typography>
       </M.Box>
     </>

diff --git a/catalog/app/containers/Bucket/Successors.tsx b/catalog/app/containers/Bucket/Successors.tsx
@@ -28,7 +28,7 @@ function EmptySlot({ bucket }: EmptySlotProps) {
       </M.Typography>
       <M.Typography>
         <StyledLink
-          href={`${docs}/advanced/workflows#cross-bucket-package-push-quilt-catalog`}
+          href={`${docs}/workflows#cross-bucket-package-push-quilt-catalog`}
           target="_blank"
         >
           Learn more
@@ -52,7 +52,7 @@ function ErrorSlot({ error }: ErrorSlotProps) {
       {error instanceof ERRORS.WorkflowsConfigInvalid && (
         <M.Typography>
           Please fix the workflows config according to{' '}
-          <StyledLink href={`${docs}/advanced/workflows`} target="_blank">
+          <StyledLink href={`${docs}/workflows`} target="_blank">
             the documentation
           </StyledLink>
         </M.Typography>

diff --git a/catalog/app/containers/Bucket/Summarize.tsx b/catalog/app/containers/Bucket/Summarize.tsx
@@ -618,7 +618,9 @@ function SummaryFailed({ error }: SummaryFailedProps) {
       <M.Typography>Check your quilt_summarize.json file for errors.</M.Typography>
       <M.Typography>
         See the{' '}
-        <Link href={`${docs}/catalog/visualizationdashboards#quilt_summarize.json`}>
+        <Link
+          href={`${docs}/quilt-platform-catalog-user/visualizationdashboards#quilt_summarize.json`}
+        >
           summarize docs
         </Link>{' '}
         for more.

diff --git a/catalog/app/containers/Bucket/errors.tsx b/catalog/app/containers/Bucket/errors.tsx
@@ -124,7 +124,7 @@ const defaultHandlers: ErrorHandler[] = [
         <br />
         <StyledLink
           target="_blank"
-          href={`${docs}/advanced/technical-reference#preparing-an-aws-role-for-use-with-quilt`}
+          href={`${docs}/quilt-platform-administrator/technical-reference#preparing-an-aws-role-for-use-with-quilt`}
         >
           Learn how to configure the bucket for Quilt
         </StyledLink>
@@ -167,7 +167,7 @@ const defaultHandlers: ErrorHandler[] = [
           <br />
           <StyledLink
             target="_blank"
-            href={`${docs}/walkthrough/working-with-the-catalog#access-control`}
+            href={`${docs}/quilt-platform-administrator/admin#users-and-roles`}
           >
             Learn about access control in Quilt
           </StyledLink>

diff --git a/catalog/app/containers/NavBar/Suggestions/Suggestions.tsx b/catalog/app/containers/NavBar/Suggestions/Suggestions.tsx
@@ -61,7 +61,10 @@ function SuggestionsList({ items, selected }: SuggestionsProps) {
       ))}
       <div className={classes.help}>
         Learn the{' '}
-        <StyledLink href={`${docs}/catalog/searchquery#search-bar`} target="_blank">
+        <StyledLink
+          href={`${docs}/quilt-platform-catalog-user/searchquery#search-bar`}
+          target="_blank"
+        >
           advanced search syntax
         </StyledLink>{' '}
         for query string queries in ElasticSearch {ES_V}.