WordPress / developer-blog-content

In this GitHub space, WordPress team coordinate content to be published on the Developer Blog. Discussion and montly meetings (first Thu) in WP Slack #core-dev-blog
36 stars 2 forks source link

Exploring the future of web development with WebAssembly and PHP #143

Closed bph closed 10 months ago

bph commented 12 months ago

Discussed in https://github.com/WordPress/developer-blog-content/discussions/135

Originally posted by **adamziel** June 21, 2023 Since Playground and WebAssembly are only going to more important, the https://developer.wordpress.org/news/ audience could be interested in an article exploring the current state and future implications of this technology. I co-authored the following article with Angel De Miguel and Rafael Fernández López from wasmlabs.dev. It is not published yet and we'd be happy to contribute it to developer.wordpress.org/news/ – what do you think? [Exploring the future of web development with WebAssembly and PHP](https://docs.google.com/document/d/1NlPLW1V6GzgHz3tWV0MWTL1_7w_Qy3pgNaJw_XEQtdg/edit#heading=h.q2wjhw6qz0fm)
Angelmmiguel commented 12 months ago

Hello @bph,

Thank you for creating the issue! I'm happy the article is moving forward. I know Adam is now on holidays, so if you can assign the issue to me, I will work on any required change on the article 😄.

bph commented 12 months ago

Thank you @Angelmmiguel for taking this on.

Here are a few tips and.guidlines for writers on the Developer Blog.

On the page, How to contribute you'll find an outline of our processes.

Feel free to connect any time with questions, moving forward with the article.

Thank you for being prepared to contribute! 🥰

Angelmmiguel commented 12 months ago

Hello @bph,

Thank you for the guidance! I took a look at the links you shared to understand better the process and writing guidelines. Adam, @ereslibre and myself already wrote a first draft for the article. Today, I took a second review based on the guidelines you shared.

I believe the article is ready for a first review 🎉. You can find the proposal in this Google Docs link: https://docs.google.com/document/d/1w2hwx5TybnyaM205rbAVyoSNehtYG4ZJ3Y-xWzirLv0/edit?usp=sharing.

Also, feel free to ask me for any required step I may missed in the process.

Thank you!

bph commented 12 months ago

@Angelmmiguel What's your WordPress.org user name? We would need it to invite you to the blog as author, so you can post the article after the 1st review... if you don't have an account yet, you can create one here, I believe

And here are instructions to connect your GitHub account to your WordPress.org account.

Angelmmiguel commented 12 months ago

Thank you for the reference @bph. I just created my account (angelmmiguel) and linked it to my GitHub account.

Angelmmiguel commented 11 months ago

Hello @bph,

Since I'll be on PTO, @ereslibre will take over this issue to apply any feedback on the article. He's an author of this article too, so he's aware of all the content 😄.

He already created a WordPress.org account and linked it to GitHub. His user is ereslibre.

Thank you!

bph commented 11 months ago

Thank you @Angelmmiguel so much for keeping an eye on this issue and initiating a handover.

Welcome @ereslibre - we will get some more eyes on this post next week after the WordPress 6.3 RC is out.

ereslibre commented 11 months ago

Hello @bph,

It's fantastic to be here, thank you! I'm super excited about this blog post.

Thank you

bph commented 11 months ago

@ereslibre Rafael, I just added you as author to the Dev Blog: "Invitation email sent to user. A confirmation link must be clicked for them to be added to your site."

And I did a first review of the post mainly changing formatting

Also, marked a couple of places we need to revisit regarding our external link policy. (YouTube, personal blogs, 3rd party products)

@marybaum when you get time would you please review the post, too?

ereslibre commented 11 months ago

Thank you @bph. I have accepted the invitation. Thanks for the formatting changes upon the first review.

I am happy to take action on whatever is needed. 👏

ereslibre commented 11 months ago

Hello @bph, just double checking. I accepted the invitation, but when logging in I am not able to see the blog post among the others. Am I supposed to be able to see it already? Thank you.

bph commented 11 months ago

Ah, I should have checked. Are you familiar with WordPress as content creation tool? We invite our writers to post their article themselves, make sure the post looks good before publishing add alt text to images, an excerpt. Etc and have a 2nd review on site before publishing.

The task getting the article published was passed on from a WordPress contributor to outside contributors made for some leaky communication. Sorry about that.

Let's wait for the next step (= posting it to the site) until @marybaum has time to do a copy review via Google docs.

Afterwards I'd be happy to post the article for you.

ereslibre commented 11 months ago

My apologies, didn't see your comments and suggestions on the Google doc. I have addressed all of them I believe. Thanks :)

Are you familiar with WordPress as content creation tool?

Yes, I have used it in the past.

Thanks for the context and information. If I got it right, we wait until Mary has done a copy review via Google docs, I address all the issues over there, and then start a draft on the Wordpress platform. Then, when it is good to go, you will perform the final publishing to the world. Is this accurate?

Thanks again.

justintadlock commented 11 months ago

Can someone open up the Google Doc for comments? This will let us review it. Thanks!

ereslibre commented 11 months ago

Can someone open up the Google Doc for comments? This will let us review it

The linked document here should be open for comments from anyone. Please, let me know if that's not the case. I tried with an incognito session and it worked as expected.

Edit: Note, I just realized that the link on the top-most comment is a different one.

justintadlock commented 11 months ago

Ah, got it. Yes, I was trying to open the one in the first post. The second link is open for comments. Thanks, @ereslibre.

justintadlock commented 11 months ago

I gave this a quick round of copyediting and left a few suggestions/comments.

Because this post is quite text-heavy, I'd look at ways of incorporating some images into it just to help break things up and capture the reader's imagination a bit more. For example, one image that you could definitely add is of WP Playground in action.

ereslibre commented 11 months ago

Thank you for your review @justintadlock! I addressed all your feedback.

Because this post is quite text-heavy, I'd look at ways of incorporating some images into it just to help break things up and capture the reader's imagination a bit more. For example, one image that you could definitely add is of WP Playground in action.

This is a great idea. Do you prefer to handle this while we move the content to WordPress and layout there, or do you prefer to layout and add this extra content on the collaborative document itself?

justintadlock commented 11 months ago

This is a great idea. Do you prefer to handle this while we move the content to WordPress and layout there, or do you prefer to layout and add this extra content on the collaborative document itself?

It'd be fine to add them in the post editor at this point. But in general, it's best to add them into Google Docs as part of the initial review process.

Angelmmiguel commented 11 months ago

This is a great idea. Do you prefer to handle this while we move the content to WordPress and layout there, or do you prefer to layout and add this extra content on the collaborative document itself?

It'd be fine to add them in the post editor at this point. But in general, it's best to add them into Google Docs as part of the initial review process.

Thanks for the suggestion @justintadlock. I will add the new images to the post. I agree the article is text-heavy, so I'll try to find more opportunities to add visual resources 😄

Angelmmiguel commented 11 months ago

Hello @bph @justintadlock,

I was about to start moving the content to the WordPress blog for a final review and publishing. I believe I don't have the "author" role in WordPress.org as I couldn't create a new draft. My username is angelmmiguel.

Thank you!

marybaum commented 11 months ago

Let me see if I can get that handled for you.

justintadlock commented 11 months ago

I sent over an invite. You should see it for the email address you use for WordPress.org.

Angelmmiguel commented 11 months ago

I got it! Thank you very much 😄

Angelmmiguel commented 10 months ago

Hello 👋 ,

We finally introduced some images and updated some styles in the article. I saved it as a draft, so you can check it on the WordPress Developer blog. I believe we're ready for the final review @bph @justintadlock 😄.

I have a question regarding the authors. I created the article, but Adam and Rafael are co-authors. How can I add them to the article?

Thank you very much for all your help and guidance here!

bph commented 10 months ago

Thank you @Angelmmiguel for posting a draft. I enabled 'public post preview' link You can give props to the co-authors and reviewers in a props section on the bottom of the article.

I will be able to review it further next week.

bph commented 10 months ago

For reviewers and writers alike:

Pre-publishing checklist:

Post-publishing checklist

marybaum commented 10 months ago

On it! Doing my editing at Contributor Day. #WCUS

Angelmmiguel commented 10 months ago

Thank you all! From my side:

justintadlock commented 10 months ago

I seemed to have missed this before, but there's a blockquote just before the "Conclusions" section:

WebAssembly provides a few well-defined features to support maximum flexibility and an incredibly large number of environments.

Who is this quote from?

If this is not a quote and meant to be a note/highlight/tip/etc., this should use the Notice block instead.

Angelmmiguel commented 10 months ago

I seemed to have missed this before, but there's a blockquote just before the "Conclusions" section:

WebAssembly provides a few well-defined features to support maximum flexibility and an incredibly large number of environments.

Who is this quote from?

If this is not a quote and meant to be a note/highlight/tip/etc., this should use the Notice block instead.

Hey @justintadlock,

Yes, this is a highlight we added when reviewing the article. Thank you for the feedback, I've just updated it to a "Notice Block" 😄

bph commented 10 months ago

Published: Exploring the future of web development with WebAssembly and PHP

adamziel commented 9 months ago

I just returned from my sabbatical and it’s great to see such an amazing collaboration here. Great job everyone 🙌

bph commented 9 months ago

Welcome back @adamziel :-)

Angelmmiguel commented 9 months ago

Hope you had a wonderful sabbatical @adamziel ! Welcome back :)

ereslibre commented 9 months ago

Welcome @adamziel! 👏 Hope you enjoyed your sabbatical :)