Skip to content

Conversation

@ckavili
Copy link

@ckavili ckavili commented Dec 6, 2025

Hey,

I am going through the docs and made some changes in the intro ordering to make onboarding much more effective for the participans and setting clearer expectations from the start. I hope it's alright 🙏 Changes I made:

  1. Prerequisites moved up - Users know immediately if they're qualified for the workshop
  2. ParasolCloud scenario introduced early - Establishes business context before diving into technical concepts
  3. Eliminated redundancy:
    - Removed duplicate P95/P99 explanation from submodule 1 (already covered in detail earlier)
    - Merged "What you'll learn" and "What you'll demonstrate" into one comprehensive section
    - Removed duplicate "Workshop structure and timing" section
    - Removed duplicate "What success looks like" section
  4. Better narrative flow:
    - Prerequisites → Business Context → Technical Concepts → Learning Outcomes → Workshop Modules → Success Criteria → FAQ → Ready to Begin
  5. Cleaner transitions:
    - Each section now flows logically to the next
    - The "Ready to begin?" section now references what they've just learned (prerequisites, scenario, goals)

The new structure follows a clear progression: Who should attend → What problem you'll solve → Why it matters → What you'll learn → How you'll learn it → What success looks like → Common questions → Let's go!

FYI @deewhyweb 😌

@ckavili ckavili requested a review from deewhyweb December 6, 2025 22:32
@ckavili
Copy link
Author

ckavili commented Dec 7, 2025

(PS: I also made some changes in the next modules as I am going along, so the PR is no long just for intro docs 🙈)

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