Learn WordPress Content Feedback - Course: Open Source Basics and WordPress
Nobody has claimed this yet.
- Dominant language
- PHP
- Stars
- 333
- Forks
- 127
- Avg merge
- 1d 7h
- Merged PRs (30d)
- 11
Description
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
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the course at https://learn.wordpress.org/course/open-source-basics-and-wordpress/ and review its introduction, principle numbering, lessons, and linked references. Confirm the desired scope with maintainers before restructuring or rewriting the material. Done means agreed corrections and improvements are updated, reviewed, and published according to the checklist.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- wordpress
- Domain
- content, documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 32/100