Including Code Best Practices in Lessons

WCMpls this weekend reminded me of something I’ve thought about before. We do our best to keep our lesson plans and examples simple and easy to understand. They work, but they are not WP best practices.

I’d like to suggest that we consider adding a section to appropriate lesson plans that has quality code that includes internationalization, accessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility), and security practices included.

So the meat of the lesson plan would be the simple, easy to teach, and easy to learn code that we are targeting, but an “Advanced” or “Bonus” or “Extra Credit” section includes the same code with the addition of the items mentioned above (and maybe a short explanation of the additions?).

Since people tend to copy and paste, and these lesson plans will be referenced as from a reputable source, it would be good to include a full-featured example somewhere.