Feedback - Developing your first WordPress block

[igorradovanov]

Type of feedback

//content

Description

In the course "Developing your first WordPress block," there's an inconsistency in how code blocks are displayed across different weeks. Currently, only Week 4 uses the syntax highlighter component, while the previous and following weeks use basic markdown syntax.

Requested improvement: All code blocks throughout the course should use the syntax highlighter component for a consistent and improved learning experience.

Benefits:

• Better readability: The syntax highlighter makes code much easier to read and understand
• Copy functionality: The copy button enables learners to quickly prototype on their private demo site provided during the course
• Professional presentation: Consistent formatting across all weeks creates a more polished learning experience

Sections that would particularly benefit:

• Week 3: My Reading List
• Anatomy of a block
• Block styling
• Block supports

These sections contain substantial amounts of code that would be significantly more accessible with proper syntax highlighting rather than plain markdown formatting.

Step-by-step reproduction instructions (optional)

1. Go to the "Developing your first WordPress block" course
2. Navigate to Week 3 and earlier weeks
3. Observe code blocks using basic markdown syntax
4. Navigate to Week 4
5. Observe the improved syntax highlighter component being used
6. Navigate to weeks after Week 4
7. Observe return to basic markdown syntax

Screenshots or screen recording (optional)

Screenshots attached showing the difference in code presentation between weeks, particularly highlighting sections with extensive code blocks that would benefit from the syntax highlighter component.

Week 3 (and other weeks missing syntax component):

Week 4 with a proper syntax component

Other information (optional)

Given that this course provides learners with a private demo site for hands-on practice, having the copy button available on all code blocks would significantly streamline the learning and experimentation process.

[rjekic]

Feedback Validation Checklist:

• If this is reporting an issue, can you confirm/reproduce the issue? (Yes or No): YES
• What should happen next to apply the feedback?:
  As @igorradovanov suggested, we should edit the course content and format the code using syntax highlighting.

cc @devmuhib009 @WordPress/learn-team

[jonathanbossenger]

Let me tackle this one. The syntax blocks were all working at the time the course was created, so I'm not sure why they are broken.

There are also some additional updates needed for that course, so I'll handle this at the same time.