Skip to content

Modernize lab guides and update migration workflow#586

Open
manojgowda-spektra wants to merge 1 commit into
CloudLabsAI-Azure:mainfrom
manojgowda-spektra:patch-2
Open

Modernize lab guides and update migration workflow#586
manojgowda-spektra wants to merge 1 commit into
CloudLabsAI-Azure:mainfrom
manojgowda-spektra:patch-2

Conversation

@manojgowda-spektra
Copy link
Copy Markdown
Contributor

🧪 PR Summary


🔄 Type of Change (Select at least one)

  • Azure Portal UI change
  • Step / instruction update
  • Content improvement (clarity/typos)
  • Screenshot update
  • Broken link fix
  • Service rename / feature deprecation
  • Dependency failure/ version conflict
  • Lab flow change
  • Validation fix
  • Optimization / better experience

📌 Reason for Change

Why was this update needed?

  • Azure UI/Workflow changed
  • Learners reported issue
  • Internal QA finding
  • Service behavior changed
  • Optimization / better experience
  • Security / compliance update

Brief explanation:

Conducted a comprehensive, repository-wide review to elevate the English language quality to production standards. Additionally, addressed a critical technical deprecation (DMA retirement) and resolved formatting glitches, hardcoded variables, and numbering sequence errors discovered during QA to ensure a flawless learner experience.


📝 What Was Modified

Describe EXACTLY what changed from learner perspective:

  • Files modified: 1.md, 2.md, 3.md, 4.md, 5.md, 6.md, 7.md, 8.md, 9.md, 10.md (Located in the Hands-on lab/ directory)

  • Old behavior / text:

  • Technical: 4.md utilized the Data Migration Assistant (DMA) for schema migration, which is a retired capability.
  • Formatting & Typos: 2.md contained a broken header (## OverviAzure) and duplicated text artifacts at the end of the file. 10.md was incorrectly labeled as "Exercise 8".
  • Variables: 10.md contained hardcoded placeholders (e.g., partsxxxx) instead of dynamic lab injection keys.
  • Language: Across all guides, there were inconsistent UI labels, run-on sentences, grammatical errors, and unprofessional phrasing that detracted from the premium feel of the lab.
  • New behavior / text:
  • Technical Overhaul (4.md): Completely rewrote the schema migration workflow to utilize the fully supported SSMS Generate Scripts wizard, including clear instructions for learners to clean up unsupported T-SQL statements prior to target execution.
  • Error Corrections: Fixed the broken header and removed duplicated lines in 2.md. Corrected the sequential numbering in 10.md from Exercise 8 to Exercise 10.
  • Dynamic Variables: Replaced all hardcoded xxxx strings in 10.md with standard <inject key="DeploymentID" enableCopy="false"/> tags to ensure seamless deployment tracking.
  • Comprehensive Language Polish: Normalized technical terminology, tightened sentence punctuation for clarity, and improved instructional tone across all 10 guides. Strictly preserved all technical content, injection tags, and screenshot paths.

🧪 Validation Done

  • Followed the lab end-to-end after changes
  • Steps are in correct sequence
  • Screenshots match current Azure UI
  • All links tested
  • No copy-paste or formatting issues
  • All injection keys strictly preserved and verified

🔗 References

  • Support ticket / issue: N/A
  • Azure announcement link: [DMA Schema Migration Retirement]
  • Learner feedback link: N/A

🧠 Reviewer Notes

Anything reviewers should double-check?

  • Lab 4 (4.md): Please verify the new SSMS Generate Scripts workflow. It is functionally accurate and acts as a direct, supported drop-in replacement for the retired DMA schema process.
  • Lab 10 (10.md): Confirm that the dynamic injection tags added to replace the old xxxx placeholders render correctly in your lab platform environment.
  • General Review: Spot-check the grammatical enhancements across the guides. The intent was to achieve a highly professional, native-English instructional tone while leaving the core lab flow entirely untouched.

Performed a comprehensive review and modernization of the App Modernization lab guides, replacing the DMA workflow with SSMS for database migration. Updated content for clarity, consistency, and accuracy across all exercises.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant