-
Notifications
You must be signed in to change notification settings - Fork 9
docs: add Activities quick start #205
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Conversation
liyuxiao2
commented
Oct 28, 2025
- readjusted the positioning for the elements on the side bar
- Added a quickstart.md file for activities
docs/activities/quick-start.md
Outdated
| - **A video** - An instructional or educational video | ||
| - **An assignment** - A single assessment or task | ||
| - **A lab** - A single hands-on interactive environment | ||
| - **A podcast** - An interactive audio |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
users don't know them as podcasts, lets change anywhere podcast is written to interactive audio
| - **Video**: For demonstrating concepts, showing procedures, or providing explanations | ||
| - **Assignment**: For assessing understanding or practicing specific skills | ||
| - **Lab**: For hands-on practice in an interactive environment |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
don't forget to add interactive audio here. I think we can remove the redundant bit in the intro. In the intro can just keep things simple and say "a single asset" -- what do you think?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I agree, but I feel like we can just remove the intro entirely, looking at it now IMO it flows better.
docs/activities/quick-start.md
Outdated
| ### 2. Open Author Workbench | ||
| - Go to the Author Workbench. | ||
| - On the left side, choose **Activities**. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
its nice to include inline links so that our ai can quickly link people to the page, I also wouldn't recommend writing where in the UI to find elements as users could be on mobile, the ui can change, etc
docs/activities/quick-start.md
Outdated
|
|
||
| > **Tip**: When designing your lab, ensure it aligns with the learning objective. Provide clear instructions and consider the learner's experience. For more detailed guidance, visit [**Labs - Quick Start**](/labs/quick-start). | ||
|
|
||
| #### Option D: Add a Podcast |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
interactive audio
docs/activities/quick-start.md
Outdated
| - Ensure the audio is clear and engaging | ||
| - Consider adding transcripts for accessibility | ||
|
|
||
| > **Tip**: Keep podcasts focused and engaging. Use clear audio quality. Consider breaking longer content into shorter episodes. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Use clear audio quality. Consider breaking longer content into shorter episodes.
its ai generated so don't think these tips are applicable