WordPress / Learn

WordPress.org Learn - The canonical source for the code and content behind https://learn.WordPress.org
243 stars 87 forks source link

Use Duotone Filters to Change Color Effects - Lesson Plan #715

Closed courtneyr-dev closed 4 weeks ago

courtneyr-dev commented 2 years ago

https://learn.wordpress.org/lesson-plan/use-duotone-filters-to-change-color-effects/

Topic Description

Include how to apply duotone filters, as well as how to add duotone settings in Global Styles and Theme.json

Related Resources

Links to related content on Learn, HelpHub, DevHub, GitHub Gutenberg Issues, DevNotes, etc.

Guidelines

Review the team guidelines

Development Checklist:

Repo Structure and Lesson Plan Template

Please remove all blockquote comments such as this before publishing.

Description

A short paragraph explaining what is covered in the lesson plan. This should be text that can be copied and used in a meetup or workshop description.

Objectives

After completing this lesson, participants will be able to:

It’s required that you include a bulleted list of objective(s) for each lesson plan. Objectives should be worded as actions that the participant can do once they’ve finished. See Bloom's Taxonomy of Action Verbs (PDF) as a reference. Avoid using words like "know," "understand," "be introduced to," etc. There should be one assement item for each objective (see below).

Target Audience

Who is this lesson intended for? What interests/skills would they bring? Put an "x" in the brackets for all that apply.

Experience Level

How much experience would a participant need to get the most from this lesson? Put an "x" in the brackets for all that apply.

Type of Instruction

Which strategies will be used for this lesson plan? Put an "x" in the brackets for all that apply.

Time Estimate (Duration)

How long will it take to present this lesson? Put an "x" in the brackets for the one that applies.

Prerequisite Skills

Participants will get the most from this lesson if they have familiarity with:

For example:

  • Experience with HTML and CSS
  • Completed the Basic WordPress Concepts lesson

Readiness Questions

A list of questions for participants to see if they have the background and skills necessary to learn and understand the lesson.

For example:

  • Do you want to makes changes to your theme yourself?
  • Do you know how to write CSS?

Slides

Change the /repo-name/ in the link to match the URL name of this repo.

Materials Needed

A list of files, resources, equipment, or other materials the presenter will need for the lesson.

For example:

  • A local install of WordPress
  • The files for the TwentySixteen theme

Notes for the Presenter

A list of any handy tips or other information for the presenter.

For example:

  • Participants may need to download the TwentySixteen theme before beginning
  • What to do if there’s no projector or internet available
  • What to do if a participant doesn’t have the necessary set up
  • How to handle different opinions about the topic

Lesson Outline

The plan for the lesson. Outline form works well.

For example:

  • Talk about what a theme is
  • Demonstrate how to install and activate a theme
  • Practice exercises to have participants find and install a theme on their own site

Exercises

Exercise name

Short description of what the exercise does and what skills or knowledge it reinforces.

These are short or specific activities that help participants practice certain components of the lesson. They should not be fully scripted exercises, but rather something that participants could do on their own. For example, you can create an exercise based on one step of the Example Lesson.

Assessment

There should be one assement item (or more) for each objective listed above. Each assessment item should support an objective; there should be none that don't.

Write out the question.

  1. Option
  2. Option
  3. Option
  4. Option

Answer: 3. Correct answer

A few questions to ask participants to evaluate their retention of the material presented. They should be a measure of whether the objectives were reached. Consider having a question for each objective.

Additional Resources

An optional section which can contain a list of resources that the presenter can use to get more information on the topic.

For example:

  • Link to information on the Codex
  • Theme Review Team's Handbook

Example Lesson

An example of how the lesson plan can be implemented. Written in script form as one possible way an presenter might use this lesson plan at an event, with screenshots and instructions if necessary.

Section Heading for Example Lesson

You will likely need to break the Example Lesson down into multiple sections.

Lesson Wrap Up

Follow with the Exercises and Assessment outlined above.

courtneyr-dev commented 2 years ago

Revise to include https://github.com/WordPress/gutenberg/issues/40061

courtneyr-dev commented 1 year ago

https://github.com/WordPress/gutenberg/pull/40435 See also: https://make.wordpress.org/core/2022/04/28/whats-new-in-gutenberg-13-1-27-april/ Minor screenshot revision needed

courtneyr-dev commented 1 year ago

Add how to unset: https://github.com/WordPress/gutenberg/pull/39564

courtneyr-dev commented 1 year ago

Demonstrate how to add Duotone to theme.json https://github.com/WordPress/gutenberg/pull/43671

Link to Theme.json lesson plan

webtechpooja commented 1 year ago

Theme.json lesson plan is not published yet - https://learn.wordpress.org/?post_type=lesson-plan&p=15349 We can link it later.

fikekomala commented 1 year ago

I want to contribute to this issue but I think I'm lost.. Has the lesson plan been published? What is left to do, exactly? (I'm an Editor)

webtechpooja commented 1 year ago

@fikekomala, yes all the WP 6.1 release related changes are done. if you want to contribute to this issue, Please review it and comment your feedback here. The link to the lesson plan: https://learn.wordpress.org/lesson-plan/use-duotone-filters-to-change-color-effects/

fikekomala commented 1 year ago

I reviewed the lesson plan according to the workflow described in the 'how to'. Here's my feedback.

  1. There's a typo in the first sentence, 'earn' should be 'learn'
  2. Under 'Materials Needed', "Theme files downloaded or beneficial if installed, You can use any block theme." 'You' should be in lowercase.
  3. Add a period for bulleted lists (where needed).
  4. Under 'How Do I add a Duotone?', "Now You can choose the color of your choice by clicking on the duotone circle." 'You' should be in lowercase.
  5. I tested the readability, it's grade 8.8 (still under 9th grade).
webtechpooja commented 1 year ago

Thank you, @fikekomala for reviewing and suggesting. I have made changes according to your feedback. Can I ask, which tool you used to test the readability?

fikekomala commented 1 year ago

Anytime, @webtechpooja. I used this https://www.perrymarshall.com/grade/ from the 'How to Use the Review in Progress Column'.

marklchaves commented 1 year ago

Hi @webtechpooja, I'd love to review this doc to get my feet wet. My first comment is for the third sentence in the intro (description). That sentence is wordy and passive (tone).

The first color can be used for the shadows on the dark section and the second one which is a light color can be used for highlighting.

These kinds of sentences are harder to read.

Here's how I would rewrite that.

For example, you can use a dark color for shadows and a light color for highlighting.

webtechpooja commented 1 year ago

Thanks, @marklchaves for your suggestion. I'll replace it. and please let me know anything else that can be improved.

marklchaves commented 1 year ago

Hey @webtechpooja,

Just some more thoughts for what they're worth 😉

I always do a grammar check with Grammarly premium. There are a few comma and passive voice fixes Grammarly suggests (see the attached screen grab).

I'd also tweak the Objective section because it mixes third-person and second-person sentences. The Lesson Plan Style Guide says, "Always write in second person ..."

And, I'd tweak the Prerequisite Skills section to make sure the intro sentence flows with the bullet points and the bullets have parallelism.

Screen Shot 2022-12-06 at 22 27 38

I'd be happy to make these changes. Just let me know.

Cheers!

webtechpooja commented 1 year ago

@marklchaves, Thank you for your suggestion. Yes Please, you can suggest the changes. Please make sure the original context of sentences will not change and that improves overall readability.

marklchaves commented 1 year ago

Hey @webtechpooja,

Not sure how you wanted my suggestions, but here they are ;-)

Duotone Lesson Plan Suggestions

Comma fixes (from Grammarly)

Objectives - Fix for mixing participants and your in the original

After completing this lesson, you'll be able to:

Prerequisite Skills - The original lead-in and bullets weren't parallel and the 3rd bullet is redundant.

Participants will get the most from this lesson if they:


Hope these help!

Cheers :-)

webtechpooja commented 1 year ago

Thank you so much @marklchaves for all your suggestion. I'll update the lesson plans accordingly.

courtneyr-dev commented 1 year ago

6.3 https://make.wordpress.org/core/2023/03/13/whats-new-in-gutenberg-15-3-13-march/#leveling-up-duotone

courtneyr-dev commented 1 year ago

https://github.com/WordPress/gutenberg/pull/49838 6.3

Duotone styles are now generated using the WordPress Style Engine, meaning that CSS is generated as part of the block supports CSS — rather than inline.

Visuals: image of Duotone Styles interface

bsanevans commented 7 months ago

//assign

github-actions[bot] commented 7 months ago

Hi @bsanevans, thanks for your interest in this issue!
If you have any questions, do not hesitate to ask them in our #training Slack channel.
Thank you for contributing!

nikonikobsan commented 7 months ago

//assign

github-actions[bot] commented 7 months ago

Hey @nikonikobsan, this issue is already assigned to @bsanevans.
A Faculty Administrator can also add you to the list of assignees or swap you with the current assignee. Or you can take a look at other unassigned issues we have.