Skip to content

docs: Deslop managing studios#1506

Merged
christopher-hakkaart merged 3 commits into
edu-893-studios-aws-batch-to-aws-cloud-migrationfrom
chris-edu-893-studios-aws-batch-to-aws-cloud-migration
Jun 3, 2026
Merged

docs: Deslop managing studios#1506
christopher-hakkaart merged 3 commits into
edu-893-studios-aws-batch-to-aws-cloud-migrationfrom
chris-edu-893-studios-aws-batch-to-aws-cloud-migration

Conversation

@christopher-hakkaart
Copy link
Copy Markdown
Member

@christopher-hakkaart christopher-hakkaart commented Jun 3, 2026

I used #1500 to manually run the deslop command I'm developing. Open to feedback.


platform-cloud/docs/studios/managing.md — "Migrate a Studio from AWS Batch to AWS Cloud" section

Structure

  • Removed the :::tip admonition — it restated the lead's recommendation. Its one fact (faster startup, simpler resource management) is now in the lead paragraph.
  • Removed the #### How it works heading and folded its paragraph into the task lead.
  • Removed the duplicate "Confirm the Studio is stopped" step — the prerequisites list already asserts it.
  • Removed the ### Troubleshooting subsection and replaced it with a one-line pointer to the Studios troubleshooting page.

Headings renamed (no inbound links to the old auto-anchors; verified)

  • In-place migration (recommended) → Migrate in place (recommended)
  • Migration from scratch → Migrate from scratch
  • Which CEs appear in the selector → Compatible compute environments
  • What happens to resource labels → Resource label changes (explicit {#resource-labels-on-migration} anchor preserved; in-page link text updated to match)

Prose

  • Replaced 4 decorative em-dashes with periods or commas.
  • Removed a , so clause join and passive constructions ("Two migration paths are supported", "is switched to CE-B", "must be copied", "must be able to").
  • Trimmed padding: "in a stopped state" → "stopped", "when you want to preserve" → "to preserve", "automatically syncs" → "syncs", removed "as described below".

Links

  • Added the [studios-troubleshooting] link definition.

platform-cloud/docs/troubleshooting_and_faqs/studios_troubleshooting.md

  • Added three migration entries (before the security-scan section), one symptom per ## heading to match the page convention:
    • New compute environment doesn't appear in the dropdown when migrating a Studio — links to the migration section in managing.md.
    • Studio fails to start after switching compute environments
    • Resource labels change after switching compute environments — links to the #resource-labels-on-migration anchor.
  • Spelled out "compute environment" throughout (CE isn't defined on this page) and used inline links to match the page style.
  • Updated last updated frontmatter to 2026-06-03.

@justinegeffen justinegeffen added the 2. Edu reviews complete Reviews complete. Remove label when confirmed in prod. label Jun 3, 2026
@christopher-hakkaart christopher-hakkaart merged commit f27ff8a into edu-893-studios-aws-batch-to-aws-cloud-migration Jun 3, 2026
0 of 2 checks passed
@christopher-hakkaart christopher-hakkaart deleted the chris-edu-893-studios-aws-batch-to-aws-cloud-migration branch June 3, 2026 21:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

2. Edu reviews complete Reviews complete. Remove label when confirmed in prod.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants