Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Block Theme Resource Round-Up #50

Closed
6 tasks done
DaisyOlsen opened this issue Jan 5, 2023 Discussed in #45 · 13 comments
Closed
6 tasks done

Block Theme Resource Round-Up #50

DaisyOlsen opened this issue Jan 5, 2023 Discussed in #45 · 13 comments
Assignees
Labels

Comments

@DaisyOlsen
Copy link

DaisyOlsen commented Jan 5, 2023

Discussed in #45

Originally posted by DaisyOlsen December 22, 2022
Similar to the topic idea in #37 - I'd like to write up a round-up style post with resources for Theme Developers, particularly for Block Themes and the gradual adoption of block theme technology. Ideally, focused on content that was new in the last several months. Since the post will not be published until 2023, I suggest avoiding calling it a 2022 wrap-up in favor of a more general Round-up.

  • workshops/courses/tutorials on learn.wordpress.org
  • wordpress.tv videos
  • dev notes
  • Useful how-to/tutorials from DevHub

To be published before the end of January 2023.

Discussion, feedback welcome!


Pre-Publish Checklist

  • Post Title in Sentence case
  • Are Category or Categories selected?
  • Are Tags identified?
  • Is there an Excerpt?
  • Props added?
  • Publish!
@bph bph added the flow: approved can move forward label Jan 6, 2023
@DaisyOlsen
Copy link
Author

It's taken me a bit longer to get this fleshed out than I hoped but I've managed to curate most of the links I'd like to include in the post. At the excellent suggestion of @bph I plan to organize the links based on function/feature with an eye toward workflow rather than chronologically as I originally thought to do.

The links are being gathered and organized into a Raindrop.io Collection

@DaisyOlsen
Copy link
Author

I have one more place to pull links from, and I can get a draft together pretty quickly for review.

@DaisyOlsen
Copy link
Author

I've created a doc with my (very) rough draft. I've organized links into what I believe to be good groupings based on general topics. I hope not to overwhelm the post with a lot of text, as I think the real value is in the content at the other end of the links and how they are organized. There are a few that I may need to change the link text for to make them more clear.

I will put a bit more work into this and plan to have it in a reviewable state before I begin my weekend. If you have any feedback on the organization of the links, please feel free to comment on the document. I'll report back when the prose section is ready for feedback.

@DaisyOlsen
Copy link
Author

This is ready for review! I would love to see this published sometime next week if possible 🥺 All feedback and suggestions are welcome. Text is intentionally on the light side because the links are the focus.

https://docs.google.com/document/d/1hqzY4H6nC7HZe6YbgzQ3FMzYxVi0OHTPe3hQigwueJw/edit?usp=sharing

I have not added a draft post yet. If that's the preferred next step, I'm happy to do so.

@DaisyOlsen DaisyOlsen added flow: needs review reviewer wanted and removed flow: approved can move forward labels Feb 10, 2023
@bph
Copy link
Collaborator

bph commented Feb 14, 2023

Hi @DaisyOlsen, I gave it a first look and added a few comments. It's a fantastic list of links in one place. It could also be immediately overwhelming if it isn't broken up into a few narrated paragraphs. I offered a few suggestions, you don't have to follow, but they might give you a few more ideas, how to guide your reader beyond the catalog.

@DaisyOlsen
Copy link
Author

Thanks for the feedback @bph I'll be working on implementing some or all of it in the next day or so :-)

@DaisyOlsen
Copy link
Author

I've implemented some of the feedback provided in the Google docs draft. I've moved it all over to a draft on the site: https://developer.wordpress.org/news/?p=832&preview=1&_ppp=bcbf2310e0

I've left the short text, and link lists as-is. This was the format I was going for to group the links without too much text around them. I'm happy to be wrong for future posts, but this seems to be the right approach to me this time around.

Would love to move this forward in the next couple of days, if possible if I get another review or two.

@abhansnuk
Copy link

abhansnuk commented Feb 17, 2023

Hi @DaisyOlsen
Thanks for this. Two suggestions:

  • breaking up this sentence as it is quite long and maybe harder to follow for those translating it as they read.
    “Whether you are just starting to use the WordPress site and styles editors or you want to read detailed explanations of newly implemented technical aspects of the theme engine, there is content from around the WordPress family of sites that will cover all of that and more.”
  • the list of links: be helpful to know which are videos etc. Aldo suggest breaking up the longer lists with some list headings / groups to make it easier to navigate back and forth from to follow each link.
@abhansnuk
Copy link

Can you please add an excerpt before it goes live, and any contributor names that are needed at the bottom. Thanks @bph and @DaisyOlsen . Back to you.

@DaisyOlsen
Copy link
Author

Thanks for the fast turnaround Abha. I'll get this wrapped up to publish tomorrow. 🎉

@mburridge
Copy link

That's a fantastic list of resources and you've done a great job in compiling the list and categorising the items within it @DaisyOlsen. The one thing I think I would like to see, and I realise it would be quite a bit more work and so potentially would delay publication so feel free to disregard, is a more detailed introduction to each section explaining the basic concepts and why you need them.

So, taking Block locking as an example - what is block locking, what purpose does it serve or what problem does it solve, and why should I follow up by clicking the links in that section and what benefits will it bring me.

This could provide the reader with "motivation" for digging into what is an excellent list of resources.

@DaisyOlsen
Copy link
Author

Great suggestions @mburridge - I will continue with the short descriptions, however. I think revisiting this post or creating something like it periodically would be a good idea. The next time, the descriptions could be fleshed out more, and the links updated to reflect the most relevant information.

@DaisyOlsen
Copy link
Author

The post has been published. Thanks to everyone for the reviews and suggestions.

https://developer.wordpress.org/news/2023/02/block-theme-resources-roundup/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
4 participants