Learn icon indicating copy to clipboard operation
Learn copied to clipboard

Learn WordPress Content Feedback - Course: Open Source Basics and WordPress

Open quitevisible opened this issue 1 year ago • 3 comments

Feedback Details

  • Content title: Open Source Basics and WordPress
  • Content URL: https://learn.wordpress.org/course/open-source-basics-and-wordpress/
  • Are you reporting an error (such as outdated information), or providing improvement ideas?: Improvement ideas.

Feedback: Errors/Corrections

  • In the course Intro/Synopsis, it might be useful to define, or provide links to an explanation of, the word 'bazaar', which might not be familiar to everyone. I recommend doing the same and linking to background articles on 'Linux' and 'Open Source'.
  • The first Lesson starts off with 'Open Source Principle 0". Unless that was intentional with some explanation behind it, I'd suggest re-numbering the OS Principles from 1-4, rather than 0-3.

Aside from that, I did not find any glaring grammatical errors, typos, or broken/dead links that needed correction. However, I do have some suggestions for consideration.

Feedback: Suggestions

  • I felt like this material as it is, would be better presented as an informative article, rather than a course.
  • IF formatted as a course, integrating the 19 Lessons/Points outlined in the referenced essay (Cathedral and Bazaar) could be the basis.
    • Ideally, there should be some demonstration or explanation of how each point relates or applies to WordPress
    • Official WPorg statements acknowledge the CAB essay philosophies to be foundational to the project's guiding principles. So it would be great to see the 'side-by-side' relationship.
  • It was unclear to me how the course author came to select the 4 OS Principles used. There is some correlation to the referenced CAB essay, but even then, the points are out of order.
  • Much of the information related to WordPress that comprise the last 3 Lessons can be found on https://wordpress.org/about/ (or links to the same info).

I found the course topic interesting, and believe that with more detailed info, would be valuable for onboarding new WPorg contributors. Perhaps with some restructuring and a rewrite, the course would achieve the desired outcome.


Feedback Report Checklist:

  • [ ] Feedback validated
  • [ ] Update proposed
  • [ ] Update reviewed
  • [ ] Update published

quitevisible avatar Jul 02 '23 23:07 quitevisible