Skip to content

feat: Migrate exercise to issue-based flow #274

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

Merged
merged 21 commits into from
May 30, 2025
Merged

Conversation

chriswblake
Copy link
Member

This pull request introduces a comprehensive update to the Markdown learning exercise, focusing on improving content clarity, restructuring steps, and enhancing workflow automation. The changes include rewriting instructional steps for better readability and updating workflows to streamline the exercise progression.

Content Updates:

Improved Markdown Exercise Steps:

  • .github/steps/1-add-headings.md: Rewritten the instructions for adding headings, replacing the term "headers" with "headings" for consistency and providing clearer examples and activity steps.
  • .github/steps/2-make-a-task-list.md: Introduced a new step for creating task lists, replacing the previous image-focused step. Added examples for unordered, ordered, and task lists with detailed activity instructions.
  • .github/steps/3-add-a-code-example.md: Enhanced the code example step by adding syntax highlighting and examples for terminal commands and JavaScript code. Updated activity to include saving a code snippet.
  • .github/steps/4-add-an-image.md: Replaced the previous task list step with instructions for adding images using both Markdown and HTML syntax, including examples for resizing and positioning.
  • .github/steps/x-review.md: Added a new review step summarizing accomplishments and providing next steps for learners, such as enabling GitHub Pages and exploring additional resources.

Workflow Enhancements:

Automation for Exercise Progression:

  • .github/workflows/0-start-exercise.yml: Created a new workflow to initialize the exercise, post step content, and automate progression tracking using GitHub Actions. This includes dynamic comments and enabling subsequent workflows.

@chriswblake chriswblake merged commit f9825dc into skills:main May 30, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

2 participants