DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194

aimurphy · 2025-03-31T21:47:23Z

Direct changes for Sideloader GA

Prepare for Sideloader GA (DOC-4238):

Bring Astra DB Sideloader docs from astra-vector-docs repo.
Separate the content into multiple pages. The first page is "About Sideloader" and you can see the other pages below that on the nav. Unless otherwise noted, the Astra DB sideloader content is the same, aside from the multi-page layout.
Add a small troubleshooting page, including the relaunch functionality (DOC-4510) and the current manual restart option.
Refresh the prerequisites and add some new ones. The PCU prerequisite and pricing information are under "Target Astra DB database requirements".
Refresh the ZDM Phase 2 page, and add sideloader as one of the options for Phase 2 of ZDM. I will probably edit this again in the future.
Add Astra DB Sideloader to the migration tools list on the migration docs index page. This is specifically for Astra DB and different from the DSE Sideloader. Note that this page will get more updates in a future PR.

General migration doc cleanup

Begin general cleanup of the migration docs:

Clean up redundant CDM content - The same partials were used on cdm-overview.adoc + cdm-steps.adoc and cassandra-data-migrator.adoc. There was no difference between the instructions aside from being on two pages vs one page. Now, the content is all on cassandra-data-migrator.adoc, and cdm-overview.adoc just includes the entire body of cassandra-data-migrator.adoc.
Remove CDM parameters content that was supposed to be removed in DOC-4573
Remove redundant partials (small amounts of content, content that was used only once, content that was commented out)
Remove unnecessary usage of ifdef and {imageprefix}
Replace outdated release notes page with links to GitHub repos for ZDM proxy, ZDM automation, and CDM.
Add links to migration content in other docsets (until we can do a more formal alignment).

The following pages will receive further edits in future PRs. They don't need a detailed review at this time:

Start to rewrite the ZDM introduction page and the doc set's index page
Start to rewrite create-target.adoc and connect-clients-to-target.adoc
Start to rewrite troubleshooting tips, and removed the redundant parent troubleshooting page that had no unique content.

⚠️ Dependent PRs

This PR is dependent on:

Serverless sideloader PR: https://github.com/riptano/astra-vector-docs/pull/894
- This is a smaller PR that modifies Astra DB Serverless by removing the sideloader content, adding a release note, and adding some other minor text regarding Sideloader.
- ⚠️ Update date in release note
Unhide sideloader PR: https://github.com/riptano/datastax-docs-site/pull/265
- Also unhide in algolia at merge time
(DONE) The PCU PRs:
- https://github.com/riptano/astra-vector-docs/pull/892
- https://github.com/riptano/datastax-docs-site/pull/260
- The PCU PRs must be merged before or with the sideloader GA PRs
- Once merged, fix the PCU links in prepare-sideloader.adoc in this PR.

plpesvc-ds · 2025-03-31T22:03:12Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-03-31T22:27:24Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-03-31T22:48:19Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

modules/sideloader/pages/prepare-sideloader.adoc

plpesvc-ds · 2025-04-01T15:24:17Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-04-01T22:17:47Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-04-01T22:33:23Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-04-03T21:05:00Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

alicel

submitting my comments so far

modules/sideloader/pages/sideloader-overview.adoc

modules/sideloader/pages/prepare-sideloader.adoc

modules/sideloader/pages/troubleshoot-sideloader.adoc

plpesvc-ds · 2025-04-07T19:44:54Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-04-07T21:43:28Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

modules/sideloader/pages/prepare-sideloader.adoc

eric-schneider

Reviewed the general migration doc cleanup. Will follow up with Sideloader + approval later tonight or tomorrow morning.

modules/ROOT/pages/cassandra-data-migrator.adoc

modules/ROOT/pages/troubleshooting-tips.adoc

eric-schneider

As always, I left a mix of observations, optional suggestions, and error corrections. This was a really long review so I'm bound to have left some pretty eye-roll comments, so please don't feel obligated to respond to any them unless you feel like it (and have time). I trust you to make the appropriate decisions with my feedback (otherwise I wouldn't have approved). Just know that I do take the time to read responses to resolved comments 🙂.

I'll end by saying that you did some phenomenal work here. This wasn't an easy feature to document, let alone migrate to a different docset. Great job! 👏👏👏

modules/sideloader/images/copy-database-id-serverless-non-vector.png

modules/sideloader/pages/cleanup-sideloader.adoc

modules/sideloader/partials/sideloader-partials.adoc

modules/sideloader/pages/troubleshoot-sideloader.adoc

plpesvc-ds · 2025-04-14T21:24:35Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-04-14T23:03:37Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-04-15T00:24:09Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-04-15T01:18:41Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-04-15T15:35:53Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-04-22T00:09:58Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-04-22T22:31:00Z

Build failure! ❌

[22:30:38.754] ERROR (asciidoctor): target of include not found: common:streaming:partial$cdc/cdc-for-astra-db.adoc file: modules/databases/pages/change-data-capture.adoc:5 source: https://github.com/riptano/astra-vector-docs.git (branch: doc-4238) > tailwindcss > tailwindcss build -c ${npm_config_tailwind_config_path} -i ${npm_config_css_path} -o ${npm_config_css_path} --minify Browserslist: caniuse-lite is outdated. Please run: npx update-browserslist-db@latest Why you should do it regularly: https://github.com/browserslist/update-db#readme Rebuilding... Done in 9062ms.

plpesvc-ds · 2025-04-23T00:44:39Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

plpesvc-ds · 2025-04-23T15:47:34Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

jeromatron · 2025-04-29T16:06:47Z

For Azure in the migration section (https://d5rxiv0do0q3v.cloudfront.net/doc-4238/data-migration/sideloader/migrate-sideloader.html), it says that Azure is in private preview. Can we get rid of that preview language for GA? I believe everything will be GA (except flexible PCU which has its own section and notes) and we don't need sideloader cloud specific preview notes any longer. Does that make sense?

plpesvc-ds · 2025-04-29T16:20:18Z

Build successful! ✅
Pull requests with matching branch name doc-4238 included in the build:

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194 (this pull request)
https://github.com/riptano/astra-vector-docs/pull/894

Deploying draft.
Deploy successful! View draft

jeromatron

Looks great, thank you April!

aimurphy added 9 commits March 28, 2025 09:33

initial move

78bff33

initial cleanup and integration

cbe2730

clean and revise cdm instructions

f1e2a58

address redundant partials

631f314

sideloader images

8f77169

delete unnecessary stuff

ec2d9f0

remove conf properties as per doc-4573

d2c873b

break up sideloader pages

7d818f1

minor adjustments

fb12935

aimurphy self-assigned this Mar 31, 2025

This comment was marked as resolved.

Sign in to view

comment temporarily broken link

0107cac

remove dsbulk loader from phase 2 nav

4beeb90

use page-alias to redirect

33def88

DomCouldwell reviewed Apr 1, 2025

View reviewed changes

modules/sideloader/pages/prepare-sideloader.adoc Outdated Show resolved Hide resolved

troubleshooting and pricing

b0362eb

troubleshooting and release notes

d07c52d

TODO

d695266

sme review 3-apr-25

095c163

alicel reviewed Apr 4, 2025

View reviewed changes

modules/sideloader/pages/sideloader-overview.adoc Outdated Show resolved Hide resolved

modules/sideloader/pages/prepare-sideloader.adoc Outdated Show resolved Hide resolved

modules/sideloader/pages/prepare-sideloader.adoc Outdated Show resolved Hide resolved

alicel reviewed Apr 4, 2025

View reviewed changes

modules/sideloader/pages/troubleshoot-sideloader.adoc Show resolved Hide resolved

modules/sideloader/pages/troubleshoot-sideloader.adoc Outdated Show resolved Hide resolved

modules/sideloader/pages/troubleshoot-sideloader.adoc Outdated Show resolved Hide resolved

add dse and mc links

331740d

tweak prerequisites

bdf7180

aimurphy commented Apr 7, 2025

View reviewed changes

modules/sideloader/pages/prepare-sideloader.adoc Outdated Show resolved Hide resolved

eric-schneider reviewed Apr 11, 2025

View reviewed changes

eric-schneider approved these changes Apr 14, 2025

View reviewed changes

typo

4ddefad

peer review pt 1 and fix Target/Origin caps

2fdceee

peer review pt 2

2054eab

peer review pt 3

718697f

small touchups

74370a3

small style sync

7fd0ffa

style tweaks

2315352

This comment was marked as duplicate.

Sign in to view

use case dependent prerequisites

641edd7

remove private preview note for azure

3c5c2ca

jeromatron approved these changes Apr 29, 2025

View reviewed changes

aimurphy merged commit f51b4fd into main Apr 30, 2025
1 check passed

aimurphy deleted the doc-4238 branch April 30, 2025 21:02

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194

DOC-4238, DOC-4510 Sideloader GA prep, Relaunch function, begin migration docs cleanup #194

Uh oh!

Conversation

aimurphy commented Mar 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Direct changes for Sideloader GA

General migration doc cleanup

⚠️ Dependent PRs

Uh oh!

This comment was marked as resolved.

plpesvc-ds commented Mar 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

plpesvc-ds commented Mar 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

plpesvc-ds commented Mar 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

plpesvc-ds commented Apr 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

plpesvc-ds commented Apr 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

plpesvc-ds commented Apr 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

plpesvc-ds commented Apr 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

alicel left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

plpesvc-ds commented Apr 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

plpesvc-ds commented Apr 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

eric-schneider left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

eric-schneider left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

plpesvc-ds commented Apr 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

plpesvc-ds commented Apr 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

aimurphy commented Mar 31, 2025 •

edited

Loading

plpesvc-ds commented Mar 31, 2025 •

edited

Loading

plpesvc-ds commented Mar 31, 2025 •

edited

Loading

plpesvc-ds commented Mar 31, 2025 •

edited

Loading

plpesvc-ds commented Apr 1, 2025 •

edited

Loading

plpesvc-ds commented Apr 1, 2025 •

edited

Loading

plpesvc-ds commented Apr 1, 2025 •

edited

Loading

plpesvc-ds commented Apr 3, 2025 •

edited

Loading

plpesvc-ds commented Apr 7, 2025 •

edited

Loading

plpesvc-ds commented Apr 7, 2025 •

edited

Loading

plpesvc-ds commented Apr 14, 2025 •

edited

Loading

plpesvc-ds commented Apr 14, 2025 •

edited

Loading

plpesvc-ds commented Apr 15, 2025 •

edited

Loading

plpesvc-ds commented Apr 15, 2025 •

edited

Loading

plpesvc-ds commented Apr 15, 2025 •

edited

Loading

plpesvc-ds commented Apr 22, 2025 •

edited

Loading

plpesvc-ds commented Apr 23, 2025 •

edited

Loading

plpesvc-ds commented Apr 23, 2025 •

edited

Loading

plpesvc-ds commented Apr 29, 2025 •

edited

Loading